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来 源 : Node.js 教 程 


整理 : 飞龙 


Node.js 简介 


nedes 


简单 的 说 Node.js 就 是 运行 在 服务 端的 JavaScript. 
Node.js 是 一 个 基于 Chrome JavaScript 运行 时 建立 的 一 个 平台 。 


Node.js 是 一 个 事件 驱动 JO 服 务 端 JavaScript 环 境 ， 基 于 Google 的 V8 引 擎 ，V8 引 擎 执行 
Javascript 的 速度 非常 快 ， 性 能 非常 好 。 
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谁 适合 阅读 本 教程 ? 


如 果 你 是 一 个 前 端 程序 员 ， 你 不 懂 的 像 PHP、Python 或 Java 等 动态 编程 语言 ， 然 后 你 想 创 建 
自己 的 服务 ， 那 么 Node.js 是 一 个 非常 好 的 选择 。 


Node.js 是 运行 在 服务 端的 JavaScript， 如 果 你 熟悉 Javascript， 那 么 你 将 会 很 容易 的 学 会 
Node.js。 


当然 ， 如 果 你 是 后 端 程序 员 ， 想 部 署 一 些 高 性 能 的 服务 ， 那 么 学 习 Node.js 也 是 一 个 非常 好 的 
选择 。 


学 习 本 教程 前 你 需要 了 解 


在 继续 本 教程 之 前 ， 你 应 该 了 解 一 些 基本 的 计算 机 编程 术语 。 如 果 你 学 习 过 Javascript,PHP， 
Java 等 编程 语言 ， 将 有 助 于 你 更 快 的 了 解 Node.js 编 程 。 


第 一 个 Node.js 程 序 : Hello World | 
脚本 模式 


以 下 是 我 们 的 第 一 个 Node.js 程 序 : 


console.log("Hello World"); 


保存 该 文件 ， 文 件 名 为 helloworld.js， 并 通过 ndem 3E 3413 : 


node helloworld.js 
程序 执行 后 ， 正 常 的 话 ， 就 会 在 终端 输出 Hello World, 


交互 模式 
打开 终端 ， 键 和 node 进入 命令 交互 模式 ， 可 以 输入 一 条 代码 语句 后 立即 执行 并 显示 结果 ， 例 
如 : 


$ node 
» console.log('Hello World!'); 
Hello World! 


Node.js 安装 配置 


本 章节 我 们 将 向 大 家 介绍 在 window 和 Linux 上 安装 Node.js 的 方法 。 
本 安装 教程 以 Node.js v0.10.26 版 本 为 例 。 


Node.js 安 装 包 及 源码 下 载 地 址 为 : http://www.nodejs.org/download/. 


Av a &» 


Windows Installer Macintosh Installer Source Code 

node-v0.10.26-x86.msi node-v0.10.26.pkg node-v0.10.26.tar.gz 
Windows Installer (.msi) 32-bit 64-bit 
Windows Binary (.exe) 32-bit 64-bit 
Mac OS X Installer (.pkg) Universal 
Mac OS X Binaries 

32-bit 64-bit 

(.tar.gz) 
Linux Binaries (.tar.gz) 32-bit 64-bit 
SunOS Binaries (.tar.gz) 32-bit 64-bit 
Source Code node-v0.10.26.tar.gz 


Note: Python 2.6 or 2.7 is required to build from source tarballs. 
根据 不 同 平台 系统 选择 你 需要 的 Node.js 安 装 包 。 


注意 : Linux 上 安装 Node.js 需 要 安装 Python 2.6 或 2.7 ， 不 建议 安装 Python 3.0 以 上 版 本 。 


Windowv 上 安装 Node.js 


Windows 安装 包 (.msi) : 

32 位 安装 包 下 载 地 址 : http://nodejs.org/dist/v0.10.26/node-v0.10.26-x86.msi 

64 位 安装 包 下 载 地 址 : http;//nodejs.org/dist/v0.10.26/x64/node-v0.10.26-x64.msi 
安装 步骤 : 


步骤 1 : 双击 下 载 后 的 安装 包 node-v0.10.26-x86.msi， 如 下 所 示 : 
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Name: E:\download\node-v0.10.26-x86.msi 
Publisher: Joyent Inc 

Type: Windows Installer Package 

From: E:\download\node-vw0.10.26-x86.msi 


[. Re | [ene J 


[V] Always ask before opening this file 


While files from the Intemet can be useful, this file type can 
potentially harm your computer. Only run software from publishers 
you trust. What's the risk? 





步骤 2: 点 击 以 上 的 Run( 运 行 )， 将 出 现 如 下 界面 : 


其 Nodejs Setup = 


Welcome to the Node.js Setup Wizard 


The Setup Wizard will install Node.js on your computer. Click 
Next to continue or Cancel to exit the Setup Wizard. 





步骤 3 : 勾 选 接受 协议 选项 ， 点 击 next (下 一 步 ) 按钮 : 


J 


配置 


Yt 
Wit 


Node.js 
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End-User License Agreement 


Please read the following license agreement carefully 





Node's license follows: 


Copyright Joyent, Inc. and other Node contributors. All rights 
reserved. Permission is hereby granted, free of charge, to any person 
obtaining a copy of this software and associated documentation files 
(the "Software"), to deal in the Software without restriction, including 
without limitation the rights to use, copy, modify, merge, publish, 
distribute, sublicense, and/or sell copies of the Software, and to 
permit persons to whom the Software is furnished to do so, subject 


tn the fnllnwinn canditinns: 


| ]I accept the terms in the License Agreement 








步骤 4 : Node.js EA 248 Bl x A "C:\Program Files\nodejs\" , 你 可 以 修改 目录 ， 并 点 击 
next (下 一 步 ) 


JË) Nodejs Setup 





Destination Folder 


Choose a custom location or dick Next to install n Pa d e ® 





Install Node.js to: 


[c:\Program Files \nodejs\, 











步骤 5: 点 击 树 形 图 标 来 选择 你 需要 的 安装 模式 ， 然后 点 击 下 一 步 next (下 一 步 ) 


Node.js 安装 配置 
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Custom Setup 


Select the way you want features to be installed. n & d e (S) i 





Click the icons in the tree below to change the way features will be installed. 


Node.js runtime Add start menu entries that link the 
npm package — the online documentation for 
hortcut Node.js 0. 10.26 and the Node.js 
Add to PATH website. 
This feature requires 1KB on your 
hard drive. 





Browse... 
[ Bak JL Wet J[ cancel | 








步骤 6 :点 击 Install (安装 ) 开始 安装 Node.js。 你 也 可 以 点 击 Back (返回 ) 来 修改 先前 的 配 
iB, 然后 并 点 击 next (下 一 步 ) 


Ready to install Node.js 





Click Install to begin the installation. Click Back to review or change any of your 
installation settings. Click Cancel to exit the wizard. 








Node.js 安装 配置 9 
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nodes 








Completed the Node.js Setup Wizard 


Click the Finish button to exit the Setup Wizard. 


Node.js has been successfully installed. 








Cancel 


检测 PATH 环境 变量 是 否 配置 了 Node.js， 点 击 开始 =》 运 行 =》 输 入 "cmd" => HAP 


邻 "path"， 输 出 如 下 结果 : 


Node.js 安装 配置 
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PATH-C:NoraclexeNappNoracleNproductN10.2.0NserverNbin;C:NWindowsNsystem32; 
C:\Windows; C:\Windows\System32\wbem; C: \Windows\System32\WindowsPowerShell\v1.0\; 
c:\python32\python;C:\MinGW\bin;C:\Program FilesNGTK2-RuntimeNlib; 

C:\Program Files\MySQL\MySQL Server 5.5\bin;C:\Program Files\nodejs\; 

Cc: \Users\rg\AppData\Roaming\npm 


我 们 可 以 看 到 环境 变量 中 已 经 包含 了 C:\Program Files\nodejs\ 


检查 Node.js 版 本 





Windows 二 进 制 文件 (.exe) 安 装 : 
32 位 安装 包 下 载 地 址 http://nodejs.org/dist/v0.10.26/node.exe 


64 位 安装 包 下 载 地 址 : http;//nodejs.org/dist/v0.10.26/x64/node.exe 


步骤 1: 双击 下 载 的 安装 包 Node.exe ， 将 出 现 如 下 界面 : 





" 
Open File - Security Warning 





Do you want to run this file? 


E Name: E:\download\node.exe 
-一 一 Publisher: Joyent Inc 

Type: Application 

From: E:\download\node.exe 


——— 


[V] Always ask before opening this file 


| > While files from the Intemet can be useful, this file type can 
ry) potentially harm your computer. Only run software from publishers 
E you trust. What's the risk? 





mu Run (477) 按钮 将 出 现 命 令 行 窗口 : 





r 


A) E\download\node.exe — c5 
^ n 





版 本 测试 
进入 node.exe 所 在 的 目录 ， 如 下 所 示 : 
E=\>cd download 


E:=\download>node --version 
v8.180.26 





如 果 你 获得 以 上 输出 结果 ， 说 明 你 已 经 成 功 安装 了 Node.js。 


Linux 22 Node.js 


Ubuntu 安装 


以 下 部 分 我 们 将 介绍 在 Ubuntu Linux F£% Node.js 。 其 他 的 Linux 系 统 ， 如 Centos 等 类 似 如 
下 安装 步骤 。 


在 Github 上 获取 Node.js 源码 : 
ritwik@ritwik-pc:~$ sudo git clone https://github.com/joyent/node.giti 


ritwik@ritwik-pc:~$ sudo git clone https://github.com/joyent/node.git 
Cloning into 'node'... 


Iremote: Reusing existing pack: 121473, done. 

Iremote: Counting objects: 49, done. 

remote: Compressing objects: 100* (46/46), done. 

Receiving objects: 8% (10851/121522), 2.84 MiB | 32 KiB/s 





在 完成 下 载 后 ， 将 源码 包 名 改 为 "node'。 


ritwik@ritwik-pc:~$ sudo git clone https://github.com/joyent/node.git 
Cloning into 'node'... 

remote: Reusing existing pack: 121473, done. 

remote: Counting objects: 49, done. 

remote: Compressing objects: 100% (46/46), done. 

remote: Total 121522 (delta 13), reused 4 (delta 3) 

Receiving objects: 100% (121522/121522), 91.16 MiB | 34 KiB/s, done. 
Resolving deltas: 100% (91075/91075), done. 

Checking out files: 100% (9604/9604), done. 

ritwik@ritwik-pc:~$ B 


修改 目录 权限 : 


ritwik@ritwik-pc:~$ sudo chmod 755 -R nodeli 


使 用 './configure' 创建 编译 文件 。 


ritwik@ritwik-pc:~/node$ sudo ./configure 
{ 'target_defaults': { 'cflags': [], 
'default configuration': 'Release', 
'defines': ['OPENSSL NO SSL2-1'], 
"include_dirs': [], 
"Ubrartes': r1). 
"variables': { 'clang': O, 
"gcc_version': 47, 
tpost archi: tase. - 
'node install npm': 'true', 
"node_prefix': '', 
‘node_shared_cares': ‘false’, 
‘node_shared_http_parser': 'false', 
‘node_shared_libuv': ‘false’, 
‘node_shared_ openssl': 'false', 
"node_shared_v8': 'false', 
‘node_shared_zlib': ‘false’, 
‘node tag’: RN 
'node use dtrace': 'false', 
'node _ use etw': 'false', 
‘node_use_mdb': 'false', 
'node use openssl': 'true', 
"node_use_perfctr': 'false', 
'node v8 options': '', 
'python': '/usr/bin/python', 
'target archi: “Las2". 
'uv library': 'static library', 
'uv parent path': '/deps/uv/', 
‘uv_use _dtrace': 'false', 
‘v8 _enable_gdbjit': 0, 
‘v8 enable ii8n support': 0, 
'v8 no strict aliasing': 1, 
'v8 optimized debug': 0, 
'v8_random_seed': 0, 
'v8_use_snapshot': 'true'}} 
creating ./config.gypi 
creating ./config.mk 
ritwik@ritwik-pc:~/node$ a 


编译 : make, 





ritwik@ritwik-pc:~/node$ sudo make 
make -C out BUILDTYPE=Release V=1 
: Entering directory '/home/ritwik/node/out' 
'-DOPENSSL NO SSL2-1' '-D DARWIN USE 64 BIT INODE-1' '-D LARGEFILE SOURCE' '-D FILE OFFSET BITS-64' '-D GNU SOURCE' '-DHAVE CONFIG H' '-DCA 

RES STATICLIB' -I../deps/cares/include -I../deps/cares/src -I../deps/cares/config/linux -pthread -Wall -Wextra -Wno-unused-parameter -m32 -g -p 
edantic -Wall -Wextra -Wno-unused-parameter --std=gnu89 -03 -ffunction-sections -fdata-sections -fno-tree-vrp -fno-omit-frame-pointer -MMD -MF 
/home/ritwik/node/out/Release/.deps//home/ritwik/node/out/Release/obj.target/cares/deps/cares/src/ares_cancel.o.d.raw -c -o /home/ritwik/node/o 
ut/Release/obj.target/cares/deps/cares/src/ares_cancel.o ../deps/cares/src/ares_cancel.c 

cc '-DOPENSSL_NO_SSL2=1' '-D_DARWIN_USE_64_BIT_INODE=1' '-D_LARGEFILE_SOURCE' '-D_FILE_OFFSET_BITS=64' '-D_GNU_SOURCE' '-DHAVE_CONFIG_H' ' 
RES_STATICLIB' -I../deps/cares/include -I../deps/cares/src -I../deps/cares/config/linux -pthread -Wall -Wextra -Wno-unused-parameter - 
edantic -Wall -Wextra -Wno-unused-parameter --std=gnu89 -03 -ffunction-sections -fdata-sections -fno-tree-vrp -fno-omit-frame-pointer 
/home/ritwik/node/out/Release/.deps//home/ritwik/node/out/Release/obj.target/cares/deps/cares/src/ares__close_sockets.o.d.raw -c -o /home/ritwi 
k/node/out/Release/obj.target/cares/deps/cares/src/ares__close_sockets.o ../deps/cares/src/ares__close_sockets.c 

cc '-DOPENSSL NO SSL2-1' '-D DARWIN USE 64 BIT INODE-1' '-D LARGEFILE SOURCE' '-D FILE OFFSET BITS-64' '-D GNU SOURCE' '-DHAVE CONFIG H' '-DCA 
RES STATICLIB' -I../deps/cares/include -I../deps/cares/src -I../deps/cares/config/linux -pthread -Wall -Wextra -Wno-unused-parameter - 
edantic -Wall -Wextra -Wno-unused-parameter --std-gnu89 -03 -ffunction-sections -fdata-sections -fno-tree-vrp -fno-omit-frame-pointer 
/home/ritwik/node/out/Release/.deps//home/ritwik/node/out/Release/obj.target/cares/deps/cares/src/ares_create_query.o.d.raw -c -o /home/ritwik/ 
node/out/Release/obj.target/cares/deps/cares/src/ares_create_query.o ../deps/cares/src/ares_create_query.c 





完成 安装 : make install, 


ritwik@ritwik-pc:~/node$ sudo make install 





最 后 我 们 输入 'node --version' 命令 来 查看 Node.js 是 否 安装 成 功 。 


ritwik@ritwik-pc:~$ node --version 
v0.11.13-pre 


ritwik@ritwik-pc:~$ Bi 





centOS F ZXnodejs 
1、 下 载 源码 ， 你 需要 在 http://nodejs.org/ 下 载 最 新 的 Nodejs 版 本 ， 本 文 以 v0.10.24 为 例 : 


cd /usr/local/src/ 
wget http://nodejs.org/dist/v0.10.24/node-v0.10.24.tar.gz 


2、 解 压 源 码 


tar zxvf node-v0.10.24.tar.gz 


3. 编译 安装 


cd node-v0.10.24 

./configure --prefix-/usr/local/node/0.10.24 
make 

make install 





4、 配 置 NODE_HOME， 进 入 profile 编 辑 环境 变量 


vim /etc/profile 


设置 nodejs 环 境 变量 ， 在 export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE 
HISTCONTROL 一 行 的 上 面 添 加 如 下 内 容 : 


#set for nodejs 
export NODE HOME-/usr/local/node/0.10.24 
export PATH-$NODE HOME/bin:S$PATH 


:wq 保 存 并 退出 ， 编 译 /etc/profile 使 配置 生效 
source /etc/profile 
验证 是 否 安装 配置 成 功 


node -v 


输出 v0.10.24 表示 配置 成 功 
npm 模 块 安装 路 径 


/usr/local/node/0.10.24/1ib/node modules/ 


x : Nodejs 官网 提供 了 编译 好 的 Linux 二 进 制 包 ， 你 也 可 以 下 载 下 来 直接 应 用 。 


= E 

Node.js 创建 第 一 个 应 用 

如 果 我 们 使 用 PHP 来 编写 后 端的 代码 时 ， 需 要 Apache 或 者 Nginx 的 HTTP 服务 器 ， 并 配 上 
mod php5 模块 和 php-cgi。 

从 这 个 角度 看 ， 整 个 "接收 HTTP 请 求 并 提供 Web 页 面 "的 需求 根本 不 需 要 PHP 来 处 理 。 


不 过 对 Node.js 来 说 ， 概 念 完全 不 一 样 了 。 使 用 Node.js 时 ， 我 们 不 仅仅 在 实现 一 个 应 用 ， 
同时 还 实现 了 整个 HTTP 服务 器 。 事 实 上 ， 我 们 的 Web 应 用 以 及 对 应 的 Web 服务 器 基本 上 
是 一 样 的 。 


在 我 们 创建 Node.js 第 一 个 "Hello, World!" 应 用 前 ， 让 我 们 先 了 解 下 Node.js 应 用 是 由 哪 几 部 
分 组 成 的 : 


1. 引入 required 模块 : 我 们 可 以 使 用 require 指令 来 载 和 人 Node.js 模块 。 
2. 创建 服务 器 : 服务 器 可 以 监听 客户 端的 请 求 ， 类似 于 Apache. Nginx 等 HTTP 服务 器 。 


3. 接收 请 求 与 响应 请 求 服务 器 很 容易 创建 ， 客 户 端 可 以 使 用 浏览 器 或 终端 发 送 HTTP 请 
求 ， 服 务 器 接收 请 求 后 返回 响应 数据 。 


创建 Node.js 应 用 


步骤 一 、 引 入 required 模块 
我 们 使 用 require 指令 来 裁 入 http 模块 ， 并 将 实例 化 的 HTTP 赋值 给 变量 http， 实 例如 下 : 


var http = require("http"); 


步骤 一 、 创 建 服务 器 


接 下 来 我 们 使 用 http.createServer() 方法 创建 服务 器 ， 并 使 用 listen 方法 绑 定 8888 端口 。 ER 
数 通过 request, response 参数 来 接收 和 响应 数据 。 


实例 如 下 ， 在 你 项 目的 根 目 录 下 创建 一 个 叫 serverjs 的 文件 ， 并 写 入 以 下 代码 : 

var http = require('http'); http.createServer(function (request, response) { // 发 送 上 
E — 18 
以 上 代码 我 们 完成 了 一 个 可 以 工作 的 HTTP 服务 器 。 





使 用 node 命令 执行 以 上 的 代码 : 


node server.js Server running at http://127.0.0.1:8888/ 


E=\nodejs>node server. js 


Server running at http://127.0.0.1:8888/ 





接 下 来 ， 打 开 浏 览 器 访问 http://127.0.0.1:8888/， 你 会 看 到 一 个 写 着 "Hello World" 的 网 页 。 
€ G [5 127.0.0.1:8888 


st 应 用 SQL to Mongo M... se Server Fault CJ 互联 网 


Hello World 


分 析 Node.js 的 HTTP 服务 器 : 


e 第 一 行 请 求 (require) Node.js 自 带 的 http 模块 ， 并 且 把 它 赋值 给 http FS. 

e 接 下 来 我 们 调用 http 模块 提供 的 函数 : createServer 。 这 个 函数 会 返回 一 个 对 象 ， 这 个 
对 象 有 一 个 叫做 listen 的 方法 ， 这 个 方法 有 一 个 数值 参数 ， 指定 这 个 HTTP 服务 器 监听 
的 端口 号 。 


Gif 实例 演示 
接 下 来 我 们 通过 Gif 图 为 大 家 演示 实例 操作 : 
> oh a p a 


PT atat aa 









打开 新 的 标签 






e^o B node — bash — 73x18 summ | 
| tiangixindeMacBook-Pro:node tiangixin$ vimi B. 

Ca li = 

| 

TU Fe Bookmarks 






NPM 使 用 介绍 


NPM 是 随同 NodeJS 一 起 安装 的 包 管 理工 具 ， 能 解决 NodeJS 代 码 部 署 上 的 很 多 问题 ， 常 见 的 
使 用 场景 有 以 下 几 种 : 


。 人 允许 用 户 从 NPM 服 务 器 下 载 别 人 编写 的 第 三 方 包 到 本 地 使 用 。 
。 多 许 用 户 从 NPM 服 务 器 下 载 并 安装 别人 编写 的 命令 行程 序 到 本 地 使 用 。 
。 多 许 用 户 将 自己 编写 的 包 或 命令 行程 序 上 传 到 NPM 服 务 器 供 别 人 使 用 。 


由 于 新 版 的 nodejs 已 经 集成 了 npm， 所 以 之 前 npm 也 一 并 安装 好 了 。 同 样 可 以 通过 输入 "npm 
v" 来 测试 是 否 成 功 安装 。 命 合 如 下 ， 出 现 版 本 提示 表示 安装 成 功 : 


$ npm -v 
2.3.0 


如 果 你 安装 的 是 旧版 本 的 npm， 可 以 很 容易 得 通过 npm 命令 来 升级 ， 命 令 如 下 : 


$ sudo npm install npm -g 
/usr/local/bin/npm -» /usr/local/lib/node modules/npm/bin/npm-cli.js 
npm@2.14.2 /usr/local/lib/node modules/npm 


AAD X d 
使 用 npm $545 Ze ls x 
npm 安装 Node.js 模块 语法 格式 如 下 : 
$ npm install «Module Name» 
以 下 实例 ， 我 们 使 用 npm 命令 安装 常用 的 Node.js web 框 架 模块 express: 


$ npm install express 


安装 好 之 后 ，express 包 就 放 在 了 工程 目录 下 的 node_modules 目录 中 ， 因 此 在 代码 中 只 需要 
通过 require('express') 的 方式 就 好 ， 无 需 指定 第 三 方 包 路 径 。 


var express = require('express'); 


FORRIN 


npm 的 包 安 装 分 为 本 地 安装 (local) 、 全 局 安装 (global) 两 种 ， 从 敲 的 命令 行 来 看 ， 差 别 
只 是 有 没有 -g 而 已 ， 比 如 


npm install express # 本 地 安装 
npm install express -g # 全 局 安装 


如 果 出 现 以 下 错误 : 
npm err! Error: connect ECONNREFUSED 127.0.0.1:8087 
解决 办 法 为 : 


$ npm config set proxy null 


本 地 安装 
。 1. 将 安装 包 放 在 ./node_modules F (运行 nnm 命令 时 所 在 的 目录 ) ， 如 果 没 有 
node modules 目录 ， 会 在 当前 执行 nom 命令 的 目录 下 生成 node modules 目录 。 
e 2. 可 以 通过 require() 来 引入 本 地 安装 的 包 。 
Smee 


e. 1. 将 安装 包 放 在 /usr/local F. 
e 2. 可 以 直接 在 命令 行 里 使 用 。 
e 3. 不 能 通过 require) 来 引入 本 地 安装 的 包 。 


接 下 来 我 们 使 用 全 局 方式 安装 express 


$ npm install express -g 


安装 过 程 输出 如 下 内 容 ， 第 一 行 输 出 了 模块 的 版 本 号 及 安装 位 置 。 


express@4.13.3 node modules/express 

m escape-html01.0.2 

— range-parser@1.0.2 

m merge-descriptors@1.0.0 

— array-flattenQ1.1.1 

— cookie@0.1.3 

— utils-merge@1.0.0 

L— parseurlQ1.3.0 

— cookie-signatureQ1.0.6 

L— methodsQ1.1.1 

L— fresh80.3.0 

L^ vary@1.0.1 

— path-to-regexp@0.1.7 

-一 content-type@1.0.1 

— etag@1.7.0 

— serve-static@1.10.0 

m content-disposition@0.5.0 

m depd@1.0.1 

-一 qs@4.0.0 

— finalhandler@0.4.0 (unpipe@1.0.0) 

m on-finished@2.3.0 (ee-first@1.1.1) 

— proxy-addr@1.0.8 (forwarded@0.1.0, ipaddr.js@1.0.1) 
m debug82.2.0 (msQ0.7.1) 

— type-is@1.6.8 (media-typer@0.3.0, mime-types@2.1.6) 
— accepts@1.2.12 (negotiator@0.5.3, mime-types@2.1.6) 
—— send@0.13.0 (destroy@1.0.3, statuses@1.2.1, msQ0.7.1, mimeQ1.3.4, http-errors@1.3.1) 


4 Em 1 
你 可 以 使 用 以 下 命令 来 查看 所 有 全 局 安装 的 模块 : 





$ npm ls -g 


使 用 package.json 


package.json 位 于 模块 的 目录 下 ， 用 于 定义 包 的 属性 。 接 下 来 让 我 们 来 看 下 express 包 的 
package.json 文件 ， 位 于 node_modules/express/package.json 内 容 : 


t 
"name": "express", 
"description": "Fast, unopinionated, minimalist web framework", 
"version": "4.13.3", 
"author": { 
"name": "TJ Holowaychuk", 
"email": "tj@vision-media.ca" 
}, 
"contributors": [ 
{ 
"name": "Aaron Heckmann", 
"email": "aaron. heckmann+github@gmail.com" 
}, 
{ 
"name": "Ciaran Jessup", 
"email": "ciaranj@gmail.com" 
}, 
{ 
"name": "Douglas Christopher Wilson", 
"email": "doug@somethingdoug.com" 
}, 
{ 
"name": "Guillermo Rauch", 


"email": "rauchg@gmail.com" 


{ 
"name": "Jonathan Ong", 
"email": "meQjongleberry.com" 
3 
{ 
"name": "Roman Shtylman", 
"email": "shtylmant+expressjs@gmail.com" 
3 
x 
"name": "Young Jae Sim", 
"email": "hanulQhanul.me" 
} 
], 
"license": "MIT", 


"repository": { 


i 


"type": "git", 
"url": "gitthttps://github.com/strongloop/express 


"homepage": "http://expressjs.com/", 
"keywords": [ 


]; 


"express", 
"framework", 
"sinatra", 
"web" 5 
"rest", 
"restful", 
"router", 


"dependencies": { 


i 


"accepts": "~1.2.12", 
"array-flatten": "1.1.1", 
"content-disposition": "0.5.0", 
"content-type": "~1.0.1", 
"cookie": "9.1.3", 
"cookie-signature": "1.0.6", 
"debug": "~2.2.0", 

"depd": "-1.0.1", 
"escape-html": "1.0.2", 

"etag": "~1.7.0", 


"finalhandler": "0.4.0", 
"fresh": "0.3.0", 
"merge-descriptors": "1.0.0", 
"methods": "~1.1.1", 
"on-finished": "-2.3.0", 
"parseurl": "-1.3.0", 
"path-to-regexp": "0.1.7", 
"proxy-addr": "~1.0.8", 

MCI SI "4.0.0", 
"range-parser": "~1.0.2", 
"send": "0.13.0", 
"serve-static": "~1.10.0", 
"type-is": "-1.6.6", 
"utils-merge": "1.0.0", 
VEVE al (Oly aby 


"devDependencies": { 


HEUPE m Green, 

Wed Suet 2135597 
"istanbul": "0.3.17", 
"marked": "0.3.5", 
"mocha": "2.2.5", 
"should": "7.0.2", 
"supertest": "1.0.1", 


"body-parser": "~1.13.3", 
"connect-redis": "~2.4.1", 
"cookie-parser": "-1.3.5", 
"cookie-session": "~1.2.0", 
"express-session": "-1.11.3", 


"jade": "-1.11.0", 


.git" 


"method-override": "-2.3.5", 
"morgan": "-1.6.1", 
"multiparty": "~4.1.2", 
"vhost": "~3.0.1" 
3 
"engines": { 
"node": ">= 0.10.0" 
3 
"files": [ 
"LICENSE", 
"History.md", 
"Readme.md", 
"index.js", 
"Tip! 
], 
"scripts": { 
"test": "mocha --require test/support/env --reporter spec --bail --check-leaks test/ 
"test-ci": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --requi 
"test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --require test/support/e 
"test-tap": "mocha --require test/support/env --reporter tap --check-leaks test/ test 
3 
"gitHead": "ef7ad681b245fba023843ce94f6bcb8e275bbb8e", 
"bugs": 
"url": "https://github.com/strongloop/express/issues" 
3 
" id": "express@4.13.3", 
" shasum": "ddb2f1fb4502bf33598d2b032b037960ca6c80a3", 
" from": "express@*", 
" npmVersion": "1.4.28", 
" npmUser": { 
"name": "dougwilson", 
"email": "doug@somethingdoug.com" 
3 
"maintainers": [ 
"name": "tjholowaychuk", 
"email": "tj@vision-media.ca" 
3 
{ 
"name": "jongleberry", 
"email": "jonathanrichardong@gmail.com" 
3 
{ 
"name": "dougwilson", 
"email": "doug@somethingdoug.com" 
3 
t 
"name": "rfeng", 
"email": "enjoyjavaQgmail.com" 
3 
t 
"name": "aredridel", 
"email": "aredridelQdinhe.net" 
3 
t 
"name": "strongloop", 
"email": "callback@strongloop.com" 
3 
t 
"name": "defunctzombie", 
"email": "shtylman@gmail.com" 
} 
], 
ost 
"shasum": "ddb2fifb4502bf33598d2b032b037960ca6c80a3", 
"tarball": "http://registry.npmjs.org/express/-/express-4.13.3.tgz" 
3 
"directories": {}, 
" resolved": "https://registry.npmjs.org/express/-/express-4.13.3.tgz", 


"readme": "ERROR: No README data found!" 


4 
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Package.json 属性 说 明 


name - 包 名 。 

version - 包 的 版 本 号 。 

description - 包 的 描述 。 

homepage - 包 的 官网 url 。 

author - 包 的 作者 姓名 。 
contributors - 包 的 其 他 贡献 者 姓名 。 


dependencies - 依赖 包 列 表 。 如 果 依 赖 包 没有 安装 ，npm 会 自动 将 依赖 包 安 装 在 
node module 目录 下 。 


repository - 包 代 码 存放 的 地 方 的 类 型 ， 可 以 是 git 或 svn, git 可 在 Github 上 。 


main - main 字段 是 一 个 模块 ID， 它 是 一 个 指向 你 程序 的 主要 项 目 。 就 是 说 ， 如 果 你 包 的 
名 字 叫 express， 然 后 用 户 安装 它 ， 然 后 require("express")。 


keywords - 关键 字 


ED sk AIR 


我 们 可 以 使 用 以 下 命令 来 卸载 Node.js 模块 。 


$ npm uninstall express 


ERA, MILEJ /node modules/ 目录 下 查看 包 是 否 还 存在 ， 或 者 使 用 以 下 命 合 查 看 : 


$ npm ls 


更 新 模块 


我 们 可 以 使 用 以 下 命令 更 新 模块 : 


$ npm update express 


搜索 模块 


使 用 以 下 来 搜索 模块 : 


$ npm search express 


创建 模块 


创建 模块 ，package.json 文件 是 必 不 可 少 的 。 我 们 可 以 使 用 NPM 生成 package.json 文件 ， 
生成 的 文件 包含 了 基本 的 结果 。 


This utility will walk you through creating a package.json file. 
It only covers the most common items, and tries to guess sensible defaults. 


See ‘npm help json' for definitive documentation on these fields 
and exactly what they do. 


Use ‘npm install «pkg» --save' afterwards to install a package and 
save it as a dependency in the package.json file. 


Press ^C at any time to quit. 

name: (node modules) runoob # 模块 名 

version: (1.0.0) 

description: Node.js 测试 模块 (www.runoob.com) # 描述 

entry point: (index.js) 

test command: make test 

git repository: https://github.com/runoob/runoob.git # Github 地 址 
keywords: 

author: 

license: (ISC) 

About to write to .../node modules/package.json: # 生成 地 址 


t 


"name": "runoob", 
"version": "1.0.0", 
"description": "Node.js 测试 模块 (www.runoob.com)"， 


Is this ok? (yes) yes 


以 上 的 信息 ， 你 需要 根据 你 自己 的 情况 输入 。 在 最 后 输入 "yes" 后 会 生成 package.json X 
件 。 


接 下 来 我 们 可 以 使 用 以 下 命令 在 npm 资源 库 中 注册 用 户 (使 用 邮箱 注册 ) 


$ npm adduser 

Username: mcmohd 

Password: 

Email: (this IS public) mcmohdQgmail.com 


接 下 来 我 们 就 用 以 下 命令 来 发 布 模块 : 
$ npm publish 


如 果 你 以 上 的 步骤 都 操作 正确 ， 你 就 可 以 跟 其 他 模块 一 样 使 用 npm 来 安装 。 


版 本 号 


使 用 NPM 下 载 和 发 布 代码 时 都 会 接触 到 版 本 号 。NPM 使 用 语义 版 本 号 来 管理 代码 ， 这 里 简单 
介绍 一 下 。 


语义 版 本 号 分 为 X.Y.Z 三 位 ， 分 别 代表 主 版 本 号 、 次 版 本 号 和 补丁 版 本 号 。 当 代码 变更 时 ， 版 
本 号 按 以 下 原则 更 新 。 


e 如 果 只 是 修复 bug， 需 要 更 新 Z 位 。 
e 如 果 是 新 增 了 功能 ， 但 是 向 下 兼容 ， 需 要 更 新 Y 位 。 
e 如 果 有 大 变动 ， 向 下 不 兼容 ， 需 要 更 新 X 位 。 


版 本 号 有 了 这 个 保证 后 ， 在 申明 第 三 方 包 依赖 时 ， 除 了 可 依赖 于 一 个 固定 版 本 号 外 ， 还 可 依 
赖 于 某 个 范围 的 版 本 号 。 例 如 "argv": "0.0.x" 表 示 依 赖 于 0.0.x 系 列 的 最 新 版 argv。 


NPM 支 持 的 所 有 版 本 号 范围 指定 方式 可 以 查看 官方 文档 。 


NPM 常用 命 兮 
除了 本 章 介 绍 的 部 分 外 ，NPM 还 提供 了 很 多 功能 ，package.json 里 也 有 很 多 其 它 有 用 的 字 
段 。 
除了 可 以 在 npmjs.org/doc/ 查 看 官方 文档 外 ， 这 里 再 介绍 一 些 NPM 常 用 命令 。 
NPM 提 供 了 很 多 命 舍 ， 例 如 install 和 publish， 使 用 npm help 可 查看 所 有 命令 。 
e NPM 提 供 了 很 多 命令 ， 例 如 install 和 publish ， 使 用 npm help 可 查看 所 有 命令 。 
e 使 用 npm help &lt;command&gt; 可 查看 某 条 命令 的 详细 帮助 ， 例 如 npm help install o 


e 在 package.json 所 在 目录 下 使 用 npm install . -g 可 先 在 本 地 安装 当前 命令 行程 序 ， 可 
用 于 发 布 前 的 本 地 测试 。 


e 使 用 npm update &lt;package&gt; 可 以 把 当前 目 录 下 node modules 子 目 录 里 边 的 对 应 模块 
更 新 至 最 新 版 本 。 


bd 使 用 npm update &lt;package&gt; -g 可 以 把 全 局 安装 的 对 应 命令 行程 序 更 新 至 最 新 版 。 


e 使 用 npm cache clear 可 以 清空 NPM 本 地 缓存 ， 用 于 对 付 使 用 相同 版 本 号 发 布 新 版 本 代码 
的 人 。 


e 使 用 npm unpublish &lt;package&gt;Q&lt;version&gt; 可 以 撤销 发 布 自己 发 布 过 的 某 个 版 
本 代码 。 


Node.js REPL(2¢ E x EE ££ Zi) 
Node.js REPL(Read Eval Print Loop: 交 互 式 解 释 器 ) 表示 一 个 电脑 的 环境 ， 类 似 Window R 
统 的 终端 或 Unix/Linux shell， 我 们 可 以 在 终端 中 输入 命 舍 ， 并 接收 系统 的 响应 。 
Node 自 带 了 交互 式 解 释 器 ， 可 以 执行 以 下 任务 : 
e 读 取 - 读 取 用 户 输入 ， 解 析 输 入 了 Javascript 数据 结构 并 存储 在 内 存 中 。 
。 执行 - 执行 输入 的 数据 结构 
e 打印 - 输出 结果 
。 循环 - 循环 操作 以 上 步骤 直到 用 户 两 次 按 下 ctrl-c 按钮 退出 。 
Node 的 交互 式 解 释 器 可 以 很 好 的 调试 Javascript 代码 。 
开始 学 习 REPL 


我 们 可 以 输入 以 下 命令 来 启动 Node 的 终端 : 


$ node 
> 


这 时 我 们 就 可 以 在 > 后 输入 简单 的 表达 式 ， 并 按 下 回 车 键 来 计算 结果 。 


简单 的 表达 式 运 算 

接 下 来 让 我 们 在 Node.js REPL 的 命 合 行 窗口 中 执行 简单 的 数学 运算 : 
node 

1 +4 

/2 


5 
3 6 


co 


229) 


SEE E Gay en cine WE 


VWVWVEVNVOV GEG 


使 用 变量 
你 可 以 将 数据 存储 在 变量 中 ， 并 在 你 需要 的 使 用 它 。 
变量 声明 需要 使 用 var 关键 字 ， 如 果 没 有 使 用 var 关键 字 变 量 会 直接 打印 出 来 。 


使 用 var 关键 字 的 变量 可 以 使 用 console.log() 来 输出 变量 。 


$ node 

> x = 10 

10 

> var y = 10 

undefined 

>xt+y 

20 

> console.log("Hello World") 
Hello World 

undefined 

> console.log("www.runoob.com") 
www.runoob.com 


undefined 
多 行 表达 式 


Node REPL 支持 输入 多 行 表达 式 ， 这 就 有 点 类 似 JavaScript。 接 下 来 让 我 们 来 执行 一 个 do- 
while 循环 : 


$ node 
> var xX = 0 
undefined 
> do { 
. X++; 
. console.log("x: " + x); 
... } while ( x <5 ); 


AUNE 


ndefined 


VOX X X XX 


… 三 个 点 的 符号 是 系统 自动 生成 的 ， 你 回 车 换行 后 即 可 。Node 会 自动 检测 是 否 为 连续 的 表达 
式 。 


下 划 线 (_) 变 量 
你 可 以 使 用 下 划 线 (_) 获 取 表 达 式 的 运算 结果 : 


$ node 

> var x = 10 
undefined 

> var y = 20 
undefined 
>x+y 

30 

> var sum = 
undefined 

> console. 1log(sum) 
30 

undefined 

> 


REPL $54; 
e ctrl + c - 退出 当前 终端 。 
e ctrl + c 按 下 两 次 - 退出 Node REPL. 
e ctrl+ d - 退出 Node REPL. 
。 向 上 /向 下 键 - 查看 输入 的 历史 命 兮 
e tab 键 - 列 出 当前 命令 
。 help- 列 出 使 用 命令 
。 break - 退出 多 行 表达 式 
。 clear - 退出 多 行 表达 式 
。 .save filename - 保存 当前 的 Node REPL 会 话 到 指定 文件 


e load filename - 载 入 当前 Node REPL 会 话 的 文件 内 容 。 


停止 REPL 
前 面 我 们 已 经 提 到 按 下 两 次 ctrl + c 建 就 能 退出 REPL: 


$ node 
> 


(^C again to quit) 
> 


Gif 实例 演示 


接 下 来 我 们 通过 Gif 图 为 大 家 演示 实例 操作 : 


W3School Node.js 教程 
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Node.js 回调 函数 
Node.js 异步 编程 的 直接 体现 就 是 回调 。 
异步 编程 依托 于 回调 来 实现 ， 但 不 能 说 使 用 了 回调 后 程序 就 异步 化 了 。 


回调 函数 在 完成 任务 后 就 会 被 调用 ，Node 使 用 了 大 量 的 回调 函数 ，Node 所 有 API 都 支持 回 
AAR, 


例如 ， 我 们 可 以 一 按 读 取 文 件 ， 一 边 执行 其 他 命令 ， 在 文件 读 取 完 成 后 ， 我 们 将 文件 内 容 作 
为 回调 本 数 的 参数 返回 。 这 样 在 执行 代码 时 就 没有 阻塞 或 等 待 文件 |/O 操作 。 这 就 大 大 提高 了 
Node.js 的 性 能 ， 可 以 义理 大 量 的 并 发 请 求 。 


阻塞 代码 实例 
创建 一 个 文件 input.txt ， 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob.com 


创建 main.js 文件 , 代码 如 下 : 


var fs = require("fs"); 
var data = fs.readFileSync('input.txt'); 


console.log(data.toString()); 
console .10g( "程序 执行 结束 !"); 


以 上 代码 执行 结果 如 下 : 


$ node main.js 
菜 乌 教程 官网 地 址 : www.runoob .com 


程序 执行 结束 ! 


非 阻 塞 代 码 实例 
创建 一 个 文件 input.txt ， 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob .com 


创建 main.js 文件 , 代码 如 下 : 


var fs - require("fs"); 
fs.readFile('input.txt', function (err, data) { 
if (err) return console.error(err); 


console.log(data.toString()); 
15 


console .10g( "程序 执行 结束 !"); 


以 上 代码 执行 结果 如 下 : 


$ node main.js 
程序 执行 结束 ! 
菜 乌 教程 官网 地 址 : www.runoob .com 


以 上 两 个 实例 我 们 了 解 了 阻塞 与 非 阻 塞 调用 的 不 同 。 第 一 个 实例 在 文件 读 取 完 后 才 执 行 完 程 
序 。 第 二 个 实例 我 们 呢 不 需要 等 待 文件 读 取 完 ， 这 样 就 可 以 在 读 取 文 件 时 同时 执行 接 下 来 的 
代码 ， 大 大 提高 了 程序 的 性 能 。 


因此 ， 阻 塞 按 是 按 顺 序 执行 的 ， 而 非 阻塞 是 不 需要 按 顺 序 的 ， 所 以 如 果 需 要 处 理 回调 函数 的 
参数 ， 我 们 就 需要 写 在 回调 函数 内 。 


Node.js 事件 循环 


Node.js 是 单 进程 单线 程 应 用 程序 ， 但 是 通过 事件 和 回调 支持 并 发 ， 所 以 性 能 非常 高 。 
Node.js 的 每 一 个 API 都 是 异步 的 ， 并 作为 一 个 独立 线程 运行 ， 使 用 异步 沙 数 调用 ， 并 处理 并 
发 。 

Node.js 基本 上 所 有 的 事件 机 制 都 是 用 设计 模式 中 观察 者 模式 实现 。 


Node.js 单线 程 类 似 进 入 一 个 while(true) 的 事件 循环 ， 直 到 没有 事件 观察 者 退出 ， 每 个 异步 事 
件 都 生成 一 个 事件 观察 者 ， 如 果 有 事件 发 生 就 调用 该 回调 函数 . 


事件 驱动 程序 

Node.js 使 用 事件 驱动 模型 ， 当 web server 接 收 到 请 求 ， 就 把 它 关 闭 然 后 进行 人 处理， 然后 去 服 
务 下 一 个 web 请 求 。 

当 这 个 请 求 完 成 ， 它 被 放 回 处 理 队 列 ， 当 到 达 队 列 开 头 ， 这 个 结果 被 返回 给 用 户 。 


这 个 模型 非常 高 效 可 扩展 性 非常 强 ， 因 为 webserver 一 直接 受 请 求 而 不 等 待 任何 读 写 操 作 。 
(这 也 被 称 之 为 非 阻塞 式 10 或 者 事件 驱动 1D) 


在 事件 驱动 模型 中 ， 会 生成 一 个 主 循环 来 监听 事件 ， 当 检测 到 事件 时 触发 回调 酚 数 。 


EventEmitters Events [下 Event Handlers 
O- ULL] 1 } 


整个 事件 驱动 的 流程 就 是 这 么 实现 的 ， 非 常 简洁 。 有 点 类 似 于 观察 者 模式 ， 事 件 相当 于 一 个 
主题 (Subject)， 而 所 有 注册 到 这 个 事件 上 的 义理 函数 相当 于 观察 者 (Observen)。 

Node.js 有 多 个 内 置 的 事件 ， 我 们 可 以 通过 引入 events 模块 ， 并 通过 实例 化 EventEmitter 类 
来 绑 定 和 监听 事件 ， 如 下 实例 : 


// 引入 events 模块 

var events - require('events'); 

// 创建 eventEmitter 对 象 

var eventEmitter = new events.EventEmitter(); 


以 下 程序 绑 定 事件 义理 程序 : 


// 绑 定 事件 及 事件 的 处 理 程序 


eventEmitter.on('eventName', eventHandler); 


我 们 可 以 通过 程序 触发 事件 : 


// 触发 事件 


eventEmitter.emit('eventName'); 


实例 
创建 main.js 文件 ， 代 码 如 下 所 示 : 


// 引入 events 模块 

var events = require('events'); 

// 创建 eventEmitter 对 象 

var eventEmitter = new events.EventEmitter(); 


// 创建 事件 处 理 程序 
var connectHandler = function connected() { 


console.10g(' 连 接 成 功 。' ) ; 


// 触发 data_received 事件 
eventEmitter.emit('data received'); 


} 


// RE connection 事件 处 理 程序 
eventEmitter.on('connection', connectHandler); 


// 使 用 匿名 函数 绑 定 data received 事件 
eventEmitter.on('data received', function(){ 


console.1og(' 数 据 接收 成 功 。 ' ) ; 
3; 


// 触发 connection 事件 
eventEmitter.emit('connection'); 


console.1og(" 程 序 执行 完毕 。" ) ; 


接 下 来 让 我 们 执行 以 上 代码 : 


$ node main.js 
连接 成 功 。 

数据 接收 成 功 。 
程序 执行 完毕 。 


Node 应 用 程序 是 如 何 工 作 的 ? 


ft Node 应 用 程序 中 ， 执 行 异步 操作 的 函数 将 回调 男 数 作为 最 后 一 个 参数 ， BBWS 


误 对 象 作为 第 一 个 参数 。 


接 下 来 让 我 们 来 重新 看 下 前 面 的 实例 ， 创 建 一 个 input.txt ,文件 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob.com 


创建 main.js 文件 ， 代 码 如 下 : 


var fs = require("fs"); 
fs.readFile('input.txt', function (err, data) { 
if (err){ 
console.log(err.stack); 
return; 
j 
console.log(data.toString()); 


3; 
console,1og(" 程 序 执行 完毕 " ) ; 


以 上 程序 中 fs.readFile() 是 异步 男 数 用 于 读 取 文件 。 如 果 在 读 取 文件 过 程 中 发 生 错 误 ， 错 误 


err 对 象 就 会 输出 错误 信息 。 


如 果 没 发 生 错误 ，readFile 跳 过 err 对 象 的 输出 ， 文 件 内 容 就 通过 回调 


执行 以 上 代码 ， 执 行 结果 如 下 : 


程序 执行 完毕 
菜 乌 教程 官网 地 址 : www.runoob .com 


接 下 来 我 们 删除 input.txt 文件 ， 执 行 结果 如 下 所 示 : 


程序 执行 完毕 
Error: ENOENT, open 'input.txt' 


因为 文件 input.txt 不 存在 ， 所 以 输出 了 错误 信息 。 


BK a Hay EH 


Node.js EventEmitter 


Node.js 所 有 的 异步 VO 操作 在 完成 时 都 会 发 送 一 个 事件 到 事件 队列 。 


Node.js 里 面 的 许多 对 象 都 会 分 发 事件 : 一 个 net.Server 对 象 会 在 每 次 有 新 连接 时 分 发 一 个 事 
44, 一 个 fs.readStream 对 象 会 在 文件 被 打开 的 时 候 发 出 一 个 事件 。 所 有 这 些 产 生 事件 的 对 象 
都 是 events.EventEmitter 的 实例 。 


EventEmitter 类 


events 模块 只 提供 了 一 个 对 象 : events.EventEmitter。 EventEmitter 的 核心 就 是 事件 触发 与 
事件 监听 器 功能 的 封装 。 


你 可 以 通过 require("events"); 来 访问 该 模块 。 


// 引入 events 模块 

var events = require('events'); 

// 创建 eventEmitter 对 象 

var eventEmitter = new events.EventEmitter(); 


EventEmitter 对 象 如 果 在 实例 化 时 发 生 错误 ， 会 触发 'error' 事件 。 当 添加 新 的 监听 器 
at, 'newListener’ 事件 会 触发 ， 当 监听 器 被 移 除 时 ，'removeListener' 事件 被 触发 。 


下 面 我 们 用 一 个 简单 的 例子 说 明 EventEmitter 的 用 法 : 


//event.js 文件 

var EventEmitter = require('events').EventEmitter; 

var event - new EventEmitter(); 

event.on('some event', function() { 
console.log('some event 事件 触发 ' ) ; 


setTimeout(function() 1 


event.emit('some event'); 
), 1000); 


执行 结果 如 下 : 


运行 这 段 代 码 ，1 秒 后 控制 台 输 出 了 'some_event 事件 触发 '。 其 原理 是 event 对 象 注册 了 事 
44 some event 的 一 个 监听 器 ， 然 后 我 们 通过 setTimeout 在 1000 毫秒 以 后 向 event 对 象 发 
送 事件 some_event， 此 时 会 调用 some_event 的 监听 器 。 


$ node event .js 
some event 事件 触发 


EventEmitter 的 每 个 事件 由 一 个 事件 名 和 若干 个 参数 组 成 ， 事 件 名 是 一 个 字符 串 ， 通 常 表 达 
一 定 的 语义 。 对 于 每 个 事件 ，EventEmitter 支持 若干 个 事件 监听 器 。 


当 事 件 触发 时 ， 注 册 到 这 个 事件 的 事件 监听 器 被 依次 调用 ， 事 件 参 数 作为 回调 酚 数 参数 传 
递 。 


让 我 们 以 下 面 的 例子 解释 这 个 过 程 : 


//event.js 文件 

var events = require('events'); 

var emitter - new events.EventEmitter(); 

emitter.on('someEvent', function(argi, arg2) { 
console.log('listeneri1', argi, arg2); 


15 
emitter.on('someEvent', function(argi, arg2) { 
console.log('listener2', argi, arg2); 


1; 
emitter.emit('someEvent', 'argi BR', 'arg2 参数 ' ) ; 


执行 以 上 代码 ， 运 行 的 结果 如 下 : /p> 


$ node event .js 
listeneri argi 参数 arg2 参数 
listener2 argi 参数 arg2 参数 


以 上 例子 中 ，emitter 为 事件 someEvent 注册 了 两 个 事件 监听 器 ， 然 后 触发 了 someEvent = 
件 。 


运行 结果 中 可 以 看 到 两 个 事件 监听 器 回调 函数 被 先后 调用 。 这 就 是 EventEmitter 最 简单 的 用 
法 。 


EventEmitter 提供 了 多 个 属性 ， 如 on 和 emit, on EXZLFH TT ZEE SRÁEPR2I, emit 属性 用 于 触 
发 一 个 事件 。 接 下 来 我 们 来 具体 看 下 EventEmitter 的 属性 介绍 。 


方法 


方法 
addListener(event, listener) 


on(event, listener) 
once(event, listener) 


removeListener(event, 
listener) 


removeAllListeners([event]) 
setMaxListeners(n) 
listeners(event) 


emit(event, [arg1], [arg2], 
[...]) 


类 方法 


方法 


listenerCount(emitter, event) 


事件 


事件 


newListener 


为 指定 事件 添加 一 个 监听 器 到 监听 器 数组 的 尾部 。 
为 指定 事件 注册 一 个 监听 器 ， 接 受 一 个 字符 串 event 和 一 : 
为 指定 事件 注册 一 个 单 次 监听 器 ， 即 监听 器 最 多 只 会 触发 


server.once('connection', function (stream) { console.1 


移 除 指定 事件 的 某 个 监听 器 ， 监 听 器 必须 是 该 事件 已 经 注 


var callback = function(stream) { console.log('someone 


移 除 所 有 事件 的 所 有 监听 器 ， 如 果 指 定 事 件 ， 则 移 除 指定 
默认 情况 下 ， EventEmitters 如 果 你 添加 的 监听 器 超过 10 
返回 指定 事件 的 监听 器 数组 。 


按 参 数 的 顺序 执行 每 个 监听 器 ， 如 果 事 件 有 注册 监听 返回 


描述 
返回 指定 事件 的 监听 器 数量 。 


描述 


event - 字符 串 ， 事 件 名 称 listener - 义理 事件 函数 该 事件 在 添加 新 
监听 器 时 被 触发 。 


event - 字符 串 ， 事 件 名 称 listener - 义理 事件 函数 从 指定 监听 器 数 


removelistener ”组 中 删除 一 


个 监听 器 。 需 要 注意 的 是 ， 此 操作 将 会 改变 处 于 被 删 监 听 


器 之 后 的 那些 监听 器 的 索引 。 


实例 


以 下 实例 通过 connection (连接 ) 事件 演示 了 EventEmitter 类 的 应 用 。 


创建 main.js 文件 ， 代 码 如 下 : 


var events - require('events'); 
var eventEmitter - new events.EventEmitter(); 


// 监听 器 #1 

var listner1 = function listner1() { 
console.log(' "ras listner1 执行 。 ' ) ， 

} 


// 监听 器 #2 

var listner2 = function listner2() { 
console.10g(' 监 听 器 listner2 A47. '); 

} 


// 绑 定 connection 事件 ， 处 理事 数 为 listner1 
eventEmitter.addListener('connection', listner1); 


// E connection 事件 ， 处 理事 数 为 listner2 
eventEmitter.on('connection', listner2); 


var eventListeners = require('events').EventEmitter.listenerCount(eventEmitter, 'connectio 
console.log(eventListeners + " 监听 器 监听 连接 事件 。" ) ; 


// &38 connection 事件 
eventEmitter.emit('connection'); 


// 移 除 监 绑 定 的 listneri B 


eventEmitter.removeListener('connection', listner1); 
console.log("listneri 不 再 受 监 听 。" ) ; 


// 触发 连接 事件 


eventEmitter.emit('connection'); 


eventListeners = require('events').EventEmitter.listenerCount(eventEmitter, 'connection'); 
console.log(eventListeners + " 监听 器 监听 连接 事件 。" ) ; 


console .10g( "程序 执行 完毕 。")， 





以 上 代码 ， 执 行 结果 如 下 所 示 : 


$ node main.js 

2 监听 器 监听 连接 事件 。 

监听 器 listner1 执行 。 
监听 器 listner2 执行 。 
listneri 不 再 受 监 听 。 

监听 器 listner2 执行 。 
1 监听 器 监听 连接 事件 。 

程序 执行 完毕 。 


error 事件 


EventEmitter 定义 了 一 个 特殊 的 事件 error， 它 包含 了 错误 的 语义 ， 我 们 在 遇 到 异常 的 时 候 通 
常会 触发 error 事件 。 


当 error 被 触发 时 ，EventEmitter 规定 如 果 没 有 响 应 的 监听 器 ，Node.js 会 把 它 当 作 有 异常 ， 退 
出 程序 并 输出 错误 信息 。 


我 们 一 般 要 为 会 触发 error 事件 的 对 象 设置 监听 器 ， 避 免 遇 到 错误 后 整个 程序 崩溃 。 例 如 : 


var events - require('events'); 
var emitter - new events.EventEmitter(); 
emitter.emit('error'); 


运行 时 会 显示 以 下 错误 : 


node.js:201 
throw e; // process.nextTick error, or 'error' event on first tick 
^ 


Error: Uncaught, unspecified 'error' event. 

at EventEmitter.emit (events.js:50:15) 

at Object.«anonymous» (/home/byvoid/error.js:5:9) 
at Module. compile (module.js:441:26) 

at Object..js (module.js:459:10) 

at Module.load (module.js:348:31) 

at Function. load (module.js:308:12) 

at Array.0 (module.js:479:10) 

at EventEmitter. tickCallback (node.js:192:40) 


继承 EventEmitter 

大 多 数 时 候 我 们 不 会 直接 使 用 EventEmitter， 而 是 在 对 象 中 继承 它 。 包 括 fs、net、 http 在 内 
的 ， 只 要 是 支持 事件 响应 的 核心 模块 都 是 EventEmitter 的 子 类 。 

为 什么 要 这 样 做 呢 ?原因 有 两 点 : 


首先 ， 具 有 某 个 实体 功能 的 对 象 实现 事件 符合 语义 ， 事件 的 监听 和 发 射 应 该 是 一 个 对 象 的 方 
法 。 


其 次 JavaScript 的 对 象 机 制 是 基于 原型 的 ， 支 持 部 分 多 重 继承 ， 继 承 EventEmitter AHEL 
对 象 原 有 的 继承 关系 。 


Node.js Buffer(24 4X) 


JavaScript 语言 自身 只 有 字符 串 数 据 类 型 ， 没 有 二 进 制 数据 类 型 。 


但 在 处 理 像 TCP 流 或 文件 流 时 ， 必 须 使 用 到 二 进 制 数据 。 因 此 在 Nodejs 中 
Buffer 类 ， 该 类 用 来 创建 一 个 专门 存放 二 进 制 数据 的 缓存 区 。 


{E Node.js Fh, Buffer 类 是 随 Node 内 核 一 起 发 布 的 核心 库 。Buffer 库 为 N 


， 定 义 了 一 个 


ode.js 带 来 了 一 种 


存储 原始 数据 的 方法 ， 可 以 让 Node.js 处理 二 进 制 数据 ， 每 当 需 要 在 Node.js 中 处理 |/O 操 作 
中 移动 的 数据 时 ， 就 有 可 能 使 用 Buffer 库 。 原 始 数据 存储 在 Buffer 类 的 实例 中 。 一 个 Buffer 


类 似 于 一 个 整数 数组 ， 但 它 对 应 于 V8 堆 内 存 之 外 的 一 块 原始 内 存 。 


创建 Buffer 类 

Node Buffer 类 可 以 通过 多 种 方式 来 创建 。 
方法 1 

创建 长 度 为 10 字 节 的 Buffer 实例 : 


var buf = new Buffer(10); 


Ne 


去 2 
通过 给 定 的 数组 创建 Buffer 实例 : 


var buf - new Buffer([10, 20, 30, 40, 50]); 


tt 
C2 


通过 一 个 字符 串 来 创建 Buffer 实例 : 


var buf = new Buffer("www.runoob.com", "utf-8"); 


utf-8 是 默认 的 编码 方式 ， 此 外 它 同样 支持 以 下 编码 : "ascii", "utf8", "utf16le 
"base64" 和 "hex"。 


写 入 缓冲 区 


"ucs2", 


语法 
€ X Node 缓冲 区 的 语法 如 下 所 示 : 


buf.write(string[, offset][, length][, encoding]) 


参数 摘 述 如 下 : 
e string - 写 入 缓冲 区 的 字符 串 。 
* offset - 缓冲 区 开始 写 入 的 索引 值 ， 黑 认为 0 。 
。 length - 写 入 的 字 节 数 ， 默 认为 bufferlength 


e encoding - 使 用 的 编码 。 黑 认为 "utf8' 。 


返回 值 


返回 实际 写 入 的 大 小 。 如 果 buffer 空间 不 足 ， 则 只 会 写 人 部 分 字符 串 。 


R> 
实例 
buf = new Buffer(256); 
len = buf.write("www.runoob.com"); 


console.10g(" 写 入 字 节 数 : "+ len); 


执行 以 上 代码 ， 输 出 结果 为 : 


$node main.js 
写 入 字 节 数 : 14 


从 缓冲 区 读 取 数据 


语法 
读 取 Node 缓冲 区 数据 的 语法 如 下 所 示 : 


buf.toString([encoding][, start][, end]) 


参数 描述 如 下 : 


e encoding - 使 用 的 编码 。 黑 认为 "utf8' 。 


e start - 指定 开始 读 取 的 索引 位 置 ， 默 认为 0。 


e end- 结束 位 置 ， 默 认为 缓冲 区 的 末尾 。 


返回 值 


解码 缓冲 区 数据 并 使 用 指定 的 编码 返回 字符 串 。 


实例 


buf = new Buffer(26); 

for (var i20; i< 26; i++) { 
buf[i] = i + 97; 

H 


console.log( buf.toString('ascii')); 
console.log( buf.toString('ascii',0,5)); 
console.log( buf.toString('utf8',0,5)); 
console.log( buf.toString(undefined,0,5)); 


执行 以 上 代码 ， 输 出 结果 为 : 


$ node main.js 
abcdefghijklmnopqrstuvwxyz 
abcde 

abcde 

abcde 


// 输出 : 
// 输出 : 
// 输出 : 


// 使 用 


将 Buffer 转换 为 JSON x & 


语法 


abcdefghijklmnopqrstuvwxyz 
abcde 

abcde 

'utf8' 编码 ， 并 输出 : abcde 


将 Node Buffer 转换 为 JSON 对 象 的 函数 语法 格式 如 下 : 


buf. toJSON() 


3 [n] fe 


返回 JSON 对 象 。 


实例 


var buf = new Buffer('www.runoob.com'); 
var json - buf.toJSON(buf); 


console.log(json); 


执行 以 上 代码 ， 输 出 结果 为 : 


[ 119, 119, 119, 46, 114, 117, 110, 111, 111, 98, 46, 99, 111, 109 ] 


缓冲 区 合并 
语法 
Node 缓冲 区 合并 的 语法 如 下 所 示 : 


Buffer.concat(list[, totalLength]) 


参数 描述 如 下 : 
e list - 用 于 合并 的 Buffer 对 象 数组 列表 。 


。 totalLength - 指定 合并 后 Buffer 对 象 的 总 长 度 。 


3 [n] 4 


返回 一 个 多 个 成 员 合 并 的 新 Buffer 对 象 。 


^ 


实例 


var bufferi = new Buffer(' 菜 乌 教 程 '); 

var buffer2 = new Buffer('www.runoob.com'); 

var buffer3 = Buffer.concat([buffer1, buffer2]); 
console.log("buffer3 AA: " + buffer3.toString()); 


执行 以 上 代码 ， 输 出 结果 为 : 


buffer3 AR: 菜 乌 教 程 www.runoob.com 


缓冲 区 比较 


Node Buffer 比较 的 函数 语法 如 下 所 示 : 


buf.compare(otherBuffer); 


参数 描述 如 下 : 


e otherBuffer - 与 buf 对 象 比较 的 另外 一 个 Buffer 对 象 。 


返回 值 


返回 一 个 数字 ， 表 示 buf 在 otherBuffer 之 前 ， 之 后 或 相同 。 


D 


实例 


var bufferi new Buffer('ABC'); 
var buffer2 new Buffer('ABCD'); 
var result = bufferi.compare(buffer2); 


if(result « 0) { 

console.log(bufferi + " f£ " + buffer2 + "之 前 "); 
jelse if(result == 0)( 

console.log(bufferi + " 与 " + buffer2 + "iB[E"); 
jelse ( 

console.log(bufferi + "在" + buffer2 + "之 后 "); 
} 


执行 以 上 代码 ， 输 出 结果 为 : 


ABC 在 ABCD 之 前 


拷贝 缓冲 区 


语法 
Node 缓冲 区 拷贝 语法 如 下 所 示 : 


buf.copy(targetBuffer[, targetStart][, sourceStart][, sourceEnd]) 


参数 描述 如 下 : 
e targetBuffer - 要 拷贝 的 Buffer 对 象 。 
。 targetStart - 数字 , 可 选 , 默认 : 0 
e sourceStart - 数字 , Ait, 默认 : 0 


。 sourceEnd - 数字 , 可 选 , 默认 : buffer.length 


var bufferi = new Buffer('ABC'); 

// 拷贝 一 个 缓冲 区 

var buffer2 = new Buffer(3); 

bufferi.copy(buffer2); 

console.log("buffer2 content: " + buffer2.toString()); 


执行 以 上 代码 ， 输 出 结果 为 : 


buffer2 content: ABC 


缓冲 区 裁剪 
Node 缓冲 区 裁剪 语法 如 下 所 示 : 


buf.slice([start][, end]) 


参数 
参数 摘 述 如 下 : 
。 start - 数字 , 可 选 , 默认 : 0 
e end - 数字 , 可 选 , 默认 : buffer.length 


退回 值 
一 个 新 的 缓冲 区 ， 它 和 旧 缓 冲 区 指向 同一 块 内 存 ， 但 是 从 索引 start 到 end 的 位 置 剪 切 。 


实例 


var bufferi = new Buffer('runoob'); 

// SAK 

var buffer2 = bufferi1.slice(0,2); 

console.log("buffer2 content: " + buffer2.toString()); 


执行 以 上 代码 ， 输 出 结果 为 : 


buffer2 content: ru 


缓冲 区 长 度 


语法 
Node 缓冲 区 长 度 计算 语法 如 下 所 示 : 


buf.length; 


返回 值 


返回 Buffer 对 象 所 占据 的 内 存 长 度 。 


实例 


var buffer = new Buffer('www.runoob.com'); 
// ”缓冲 区 长 度 
console.log("buffer length: " + buffer.length); 


执行 以 上 代码 ， 输 出 结果 为 : 


buffer length: 14 


方法 参考 手册 


以 下 列 出 了 Node.js Buffer 模块 常用 的 方法 (注意 有 些 方 法 在 旧版 本 是 没有 的 ) 
方法 
now Buffer(Size) 将 会 抛 出 异常 RangeError。 
new Buffer(buffer) 拷贝 参数 buffer 的 数据 到 Buffer 实例 。 


描述 


分 配 一 个 新 的 size 大 小 单位 为 8 位 字 节 的 buffer。 


注意 , size 


new Buffer(str[, 
encoding]) 


buf.length 


buf.write(string[, offset][, 
length][, encoding]) 


buf.writeUIntLE(value, 
offset, byteLength[, 
noAssert]) 


buf.writeUIntBE(value, 
offset, byteLength[, 
noAssert]) 


buf.writelntLE(value, 
offset, byteLength[, 
noAssert]) 


buf.writelntBE(value, 
offset, byteLength[, 
noAssert]) 


buf.readUIntLE(offset, 
byteLength[, noAssert]) 


buf.readUIntBE(offset, 
byteLength[, noAssert]) 


buf.readintLE(offset, 
byteLength[, noAssert]) 


buf.readintBE(offset, 
byteLength[, noAssert]) 


buf.toString([encoding][, 
start][, end]) 


buf.toJSON() 
buf[index] 


buf.equals(otherBuffer) 
buf.compare(otherBuffer) 


buf.copy(targetBuffer[, 
targetStart][, sourceStart] 
[, sourceEnd]) 


buf.slice([start][, end]) 


分 配 一 个 新 的 buffer ， 其 中 包含 着 传人 的 str 字符 串 。 ence 


返回 这 个 buffer 的 bytes 数 。 注 意 这 未 必 是 buffer 里 面 内 容 
分 配 的 内 存 数 ， 它 不 会 随 着 这 个 buffer 对 象 内 容 的 改变 而 改 


根据 参数 offset 偏 移 量 和 指定 的 encoding 252275 X, HB? 
偏 移 量 默认 值 是 0, encoding 编码 方式 默认 是 utf8。 length 
大 小 。 返回 number 类 型 ， 表 示 写 入 了 多 少 8 AFP A 
个 string， 它 将 只 会 只 写 人 部 分 字符 串 。 length 默认 是 buff 
出 现 写 入 部 分 字符 。 


value 写 入 到 buffer 里 ， 它 由 offset 和 byteLength RE, 
var b = new Buffer(6); b.writeUIntBE(0x1234567890ab, 0, 6 


noAssert 44 7; true 时 ， 不 再 验证 value 和 offset 的 有 效 性 。 


将 value 写 入 到 buffer 里 ， 它 由 offset 和 byteLength 决定 ， 
true 时 ， 不 再 验证 value 和 offset 的 有 效 性 。 默认 是 false。 


将 value E Al buffer 里 ， 它 由 offset 和 byteLength RE, 
true 时 ， 不 再 验证 value 和 offset 的 有 效 性 。 默认 是 false。 


将 value 写 入 到 buffer 里 ， 它 由 offset 和 byteLength RE, 
true 时 ， 不 再 验证 value 和 offset 的 有 效 性 。 默认 是 false。 





支持 读 取 48 位 以 下 的 数字 。noAssert 值 为 true 时 ， offset 
度 ， 默 认为 false。 
支持 读 取 48 位 以 下 的 数字 。noAssert 值 为 true 时 ， offset 
E, Eu false. 
支持 读 取 48 位 以 下 的 数字 。noAssert 值 为 true 时 ， offset 
度 ， 默 认为 false。 
支持 读 取 48 位 以 下 的 数字 。noAssert 值 为 true 时 ， offset 


度 ， 默 认为 false. 


根据 encoding 参数 (默认 是 "utf8') 返回 一 个 解码 过 的 strir 
start (默认 是 0) 和 end (默认 是 buffer.length) 作 为 取 值 范围 。 


将 Buffer 实例 转换 为 JSON 对 象 。 


获取 或 设置 指定 的 字 节 。 返 回 值 代表 一 个 字 节 ， 所 以 返回 值 
OxFF 或 者 十 进 制 0 至 255。 


比较 两 个 缓冲 区 是 否 相 等 ， 如 果 是 返回 true， 否 则 返回 fals: 
比较 两 个 Buffer 对 象 ， 返 回 一 个 数字 ， 表 示 buf 在 otherBu 


buffer 拷贝 ， 源 和 目标 可 以 相同 。 targetStart 目标 开始 偏 移 
是 0。 sourceEnd 源 结束 位 置 偏 移 默认 是 源 的 长 度 bufferle 


851] Buffer 对 象 ， 根 据 start( 默 认 是 0 ) 和 end (默认 是 buff 
负 的 索引 是 从 buffer 尾部 开始 计算 的 。 


buf.readUInt8(offset[, 
noAssert]) 


buf.readUInt16LE(offset[, 
noAssert]) 


buf.readUInt16BE(offset[, 
noAssert]) 


buf.readUInt32LE(offset[, 
noAssert]) 


buf.readUInt32BE(offset[, 
noAssert]) 


buf.readint8(offset[, 
noAssert]) 


buf.readint16LE(offset[, 
noAssert]) 


buf.readint16BE(offset[, 
noAssert]) 


buf.readInt32LE(offset[, 
noAssert]) 


buf.readint32BE(offset[, 
noAssert]) 


buf.readFloatLE(offset[, 
noAssert]) 


buf.readFloatBE(offset[, 
noAssert]) 


buf.readDoubleLE(offset[, 


noAssert]) 


buf.readDoubleBE(offset[, 


noAssert]) 


buf.writeUInt8(value, 
offset[, noAssert]) 


根据 指定 的 偏 移 量 ， 读 取 一 个 有 符号 8 位 整数 。 若 参数 no^ 
移 量 参数 。 如 果 这 样 offset 可 能 会 超出 buffer MAE. Bir 


根据 指定 的 偏 移 量 ， 使 用 特殊 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false. 


根据 指定 的 偏 移 量 ， 使 用 特殊 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参 数 。 这 意味 着 
默认 是 false. 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 污 取 一 < 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false。 


根据 指定 的 偏 移 量 ， 读 取 一 个 signed 8 位 整数 。 若 参数 no 
偏 移 量 参数 。 这 意味 着 offset 可 能 会 超出 buffer 的 末尾 。 黑 


根据 指定 的 偏 移 量 ， 使 用 特殊 的 endian 格式 读 取 一 个 signe 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 offset We 
false。 


根据 指定 的 偏 移 量 ， 使 用 特殊 的 endian 格式 读 取 一 个 signe 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 offset VF 
false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 污 取 一 < 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false, 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格 式 读 取 一 - 
noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 
默认 是 false. 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian = 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 
false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 污 取 一 < 
为 true 将 不 会 验证 offset 偏 移 量 参数 。 这 意味 着 offset 可 和 有 
false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 读 取 一 个 
为 true 将 不 会 验证 Offset 偏 移 量 参数 。 这 意味 着 offset Wk 
false。 


根据 指定 的 偏 移 量 ， 使 用 指定 的 endian 字 节 序 格式 读 取 一 个 
为 true 将 不 会 验证 Offset 偏 移 量 参数 。 这 意味 着 offset 可 和 有 
false。 


根据 传 入 的 offset 偏 移 量 将 value SA buffer。 注 意 : value 
数 。 若 参 数 noAssert 为 true 将 不 会 验证 offset 偏 移 量 参数 
者 offset 可 能 会 超出 buffer 的 末尾 从 而 造成 value RFF. 


节 序 格式 读 取 一 了 
意味 着 offset 可 


buf.writeUInt16LE(value, 
offset[, noAssert]) 


buf.writeUInt16BE(value, 
offset[, noAssert]) 


buf.writeUInt32LE(value, 
offset[, noAssert]) 


buf.writeUInt32BE(value, 
offset[, noAssert]) 


buf.writelnt8(value, 
offset[, noAssert]) 


buf.writelnt16LE(value, 
offset[, noAssert]) 


buf.writelnt16BE(value, 
offset[, noAssert]) 


buf.writelnt32LE(value, 
offset[, noAssert]) 


buf.writelnt32BE(value, 
offset[, noAssert]) 


buf.writeFloatLE(value, 
offset[, noAssert]) 


buf.writeFloatBE(value, 
offset[, noAssert]) 


buf.writeDoubleLE(value, 


否则 不 要 使 用 。 默 认 是 false。 


人 offset 偏 移 量 和 指定 的 endian 格式 将 value E 7 

合法 的 有 符号 16 位 整数 。 若 参 数 noAssert 为 true 将 不 : 
s. 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buff 
除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 默 认 是 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value $J 
个 合法 的 有 符号 16 位 整数 。 若 参 数 noAssert 为 true 将 不 : 
数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buff 
除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 默 认 是 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value $J 
合法 的 有 符号 32 位 整数 。 若 参 数 noAssert 为 true HRA! 
这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buffer 的 末 上 
对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 黑 认 是 false。 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value $J 
合法 的 有 符号 32 位 整数 。 若 参 数 noAssert 为 true HRA! 
这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buffer 的 末 上 
对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 默 认 是 false。 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value $J 
个 合法 的 signed 16 位 整数 。 若 参 数 noAssert 为 true 将 不 
数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buf 
Jt, 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


根据 传人 的 offset (at? SB AIR ERY endian 格式 将 value $J 
个 合法 的 signed 16 位 整数 。 若 参 数 noAssert 为 true 将 不 
数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buf 
Jt, 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


人 offset 偏 移 量 和 指定 的 endian 格式 将 value 7 

合法 的 signed 32 位 整数 。 AEM noAssert 为 true 将 不 
" 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buf 
jt, 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value & 7 
个 合法 的 signed 32 位 整数 。 若 参 数 noAssert 为 true 将 不 
数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 buf 
jt, 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value $J 
个 32 位 浮 点 数 类 型 的 值 时 ， 结 果 将 是 不 确定 的 。 若 参 数 n 
和 offset 偏 移 量 参数 。 这 意味 着 value 可 能 过 大 ， 或 者 offs' 
造成 value RAF. 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 斥 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value $J 
个 32 位 浮 点 数 类 型 的 值 时 ， 结 果 将 是 不 确定 的 。 若 参 数 nt 
和 offset 偏 移 量 参数 。 这 意味 着 value 可 能 过 大 ， 或 者 offs' 
造成 value RAF. 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 斥 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value & 7 
个 有 效 的 64 位 double 类 型 的 值 。 ABM noAssert 为 true 


offset[, noAssert]) 


buf.writeDoubleBE(value, 
offset[, noAssert]) 


buf.fill(value[, offset][, 
end]) 


参数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 b 
jt, 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 明 


根据 传人 的 offset 偏 移 量 和 指定 的 endian 格式 将 value $J 
个 有 效 的 64 位 double 类 型 的 值 。 若 参 数 noAssert 为 true 
参数 。 这 意味 着 value 可 能 过 大 ， 或 者 offset 可 能 会 超出 b 
$t, 除非 你 对 这 个 参数 非常 有 把 握 ， 否 则 尽量 不 要 使 用 。 蝎 


使 用 指定 的 value 来 填充 这 个 buffer。 如 果 没 有 指定 offset ( 
buffer.length) ， 将 会 填充 整个 buffer。 


Node.js Stream( 流 ) 
Stream 是 一 个 抽象 接口 ，Node 中 有 很 多 对 象 实 现 了 这 个 接口 。 例 如 ， 对 http 服务 器 发 起 请 
求 的 request 对 象 就 是 一 个 Stream， 还 有 stdout (标准 输出 ) 。 
Node.js, Stream 有 四 种 流 类 型 : 
e Readable - 可 读 操作 。 
。 Writable - 可 写 操 作 。 
e Duplex - 可 读 可 写 操 作 . 
e Transform - 操作 被 写 人 数据 ， 然 后 读 出 结果 。 
所 有 的 Stream 对 象 都 是 EventEmitter 的 实例 。 常 用 的 事件 有 : 
e data - 当 有 数据 可 读 时 触发 。 
。 end - 没有 更 多 的 数据 可 读 时 触发 。 
。 error - 在 接收 和 写 入 过 程 中 发 生 错误 时 触发 。 
e finish - 所 有 数据 已 被 写 入 到 底层 系统 时 触发 。 
本 教程 会 为 大 家 介绍 常用 的 流 操 作 。 


从 流 中 读 取 数据 
创建 input.txt 文件 ， 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob .com 


创建 main.js 文件 , 代码 如 下 : 


var fs - require("fs"); 
var data = ''; 


// 创建 可 读 流 
var readerStream = fs.createReadStream('input.txt'); 


// 设置 编码 为 Utf8。 
readerStream.setEncoding( UTF8'); 


// 处 理 流 事件 --> data, end, and error 
readerStream.on('data', function(chunk) { 
data += chunk; 


3); 


readerStream.on('end', function(){ 
console. log(data) ; 


3); 


readerStream.on('error', function(err){ 
console.log(err.stack); 


3); 


console.1og(" 程 序 执行 完毕 ") ， 


以 上 代码 执行 结果 如 下 : 


程序 执行 完毕 
菜 乌 教程 官网 地 址 : www. runoob .com 


创建 main.js 文件 , 代码 如 下 : 


var fs = require("fs"); 
var data = ' 菜 乌 教 程 官网 地 址 : www.runoob.com'; 


// 创建 一 个 可 以 宇 入 的 流 ， 写 入 到 文件 output.txt 中 
var writerStream = fs.createwriteStream('output.txt'); 


// 使 用 utf8 编码 写 入 数据 
writerStream.write(data, 'UTF8'); 


// 标记 文件 末尾 


writerStream.end(); 


// 处 理 流 事件 --> data, end, and error 

writerStream.on('finish', function() { 
console.1og(" 写 入 完成 。" ) ; 

3); 


writerStream.on('error', function(err){ 
console.log(err.stack); 


3); 


console.1og(" 程 序 执行 完毕 " ) ; 


以 上 程序 会 将 data 变量 的 数据 写 入 到 output.txt 文件 中 。 代 码 执 行 结果 如 下 : 


$ node main.js 
程序 执行 完毕 
写 入 完成 。 


查看 output.txt 文件 的 内 容 : 


$ cat output.txt 
菜 乌 教程 官网 地 址 : www.runoob.com 


管道 流 
管道 提供 了 一 个 输出 流 到 输入 流 的 机 制 。 通 常 我 们 用 于 从 一 个 流 中 获取 数据 并 将 数据 传送 到 
另外 一 个 流 中 。 


source 


dest 一 一) 


如 上 面 的 图 片 所 示 ， 我 们 把 文件 比 作 装 水 的 桶 ， 而 水 就 是 文件 里 的 内 容 ， 我 们 用 一 根 管 子 
(pipe) 连 接 两 个 桶 使 得 水 从 一 个 桶 流入 另 一 个 桶 ， 这 样 就 慢 慢 的 实现 了 大 文件 的 复制 过 程 。 


以 下 实例 我 们 通过 读 取 一 个 文件 内 容 并 将 内 容 写 入 到 另外 一 个 文件 中 。 
设置 input.txt 文件 内 容 如 下 : 


教程 官网 地 址 : www. runoob.com 
流 操作 实例 


KS 
管道 


创建 main.js 文件 , 代码 如 下 : 


var fs - require("fs"); 


// 创建 一 个 可 读 流 


var readerStream = fs.createReadStream('input.txt'); 


// 创建 一 个 可 写 流 


var writerStream = fs.createwriteStream('output.txt'); 


// 管道 读 写 操作 





// 读 取 input.txt 文件 内 容 ， 并 将 内 容 写 入 到 output.txt 文件 中 


readerStream.pipe(writerStream); 


console,1og(" 程 序 执行 完毕 " ) ; 


代码 执行 结果 如 下 : 


$ node main.js 
程序 执行 完毕 


查看 output.txt 文件 的 内 容 : 


$ cat output.txt 
菜 乌 教程 官网 地 址 : www.runoob .com 
管道 流 操作 实例 


ft zT 


链 式 是 通过 连接 输出 流 到 另外 一 个 流 并 创建 多 个 对 个 流 操 作 链 的 机 制 。 链 式 流 一 般 用 于 管道 


接 下 来 我 们 就 是 用 管道 和 链 式 来 压缩 和 解压 文件 。 
创建 compress.js x fF, 代码 如 下 : 


var fs 


- require("fs"); 
var zlib - 


require('zlib'); 

// 压缩 input.txt FA input.txt.gz 

fs.createReadStream('input.txt') 
.pipe(zlib.createGzip()) 
.pipe(fs.createwriteStream('input.txt.gz')); 


console.1og(" 文 件 压 缩 完成 。" ) ; 


代码 执行 结果 如 下 : 


$ node compress.js 


文件 压缩 完成 。 


执行 完 以 上 操作 后 ， 我 们 可 以 看 到 当前 目录 下 生成 了 input.txt 85/5 


压缩 文件 input.txt.gz。 


接 下 来 ， 让 我 们 来 解压 该 文件 ， 创 建 decompress.js 文件 ， 代 码 如 下 : 


var fs 


- require("fs"); 
var zlib - 


require('zlib'); 
// 解压 input.txt.gz 文件 为 input.txt 
fs.createReadStream('input.txt.gz') 


.pipe(zlib.createGunzip()) 
.pipe(fs.createwriteStream('input.txt')); 


console.1og(" 文 件 解压 完成 。" ) ; 


代码 执行 结果 如 下 : 


$ node decompress.js 


文件 解压 完成 。 


Node.js 模 块 系统 


为 了 让 Node.js 的 文件 可 以 相互 调用 ，Node.js 提 供 了 一 个 简单 的 模块 系统 。 


模块 是 Node.js 应 用 程序 的 基本 组 成 部 分 ， 文 件 和 模块 是 一 一 对 应 的 。 换 言 之 ， 一 个 Node.js 
文件 就 是 一 个 模块 ， 这 个 文件 可 能 是 JavaScript 代码 、JSON 或 者 编译 过 的 C/C++ 扩展 。 


创建 模块 
在 Node.js 中 ， 创 建 一 个 模块 非常 简单 ， 如 下 我 们 创建 一 个 ,main.js' 文件 ， 代 码 如 下 : 


var hello = require('./hello'); 
hello.world(); 


以 上 实例 中 ， 代 码 require('/hello') 引入 了 当前 目录 下 的 hello.js 文 件 (./ 为 当前 目录 ，node.js 
默认 后 级 为 js) o 


Node.js 提供 了 exports 和 require 两 个 对 象 ， 其 中 exports 是 模块 公开 的 接口 ，require 用 于 
从 外 部 获取 一 个 模块 的 接口 ， 即 所 获取 模块 的 exports 对 象 。 


接 下 来 我 们 就 来 创建 hello.js 文 件 ， 代 码 如 下 : 


exports.world = function() { 
console.log('Hello World'); 


在 以 上 示例 中 ，hello.js 通过 exports 对 象 把 world 作为 模块 的 访 问 接口 ， 在 main.js 中 通过 
require('/hello") 加 载 这 个 模块 ， 然 后 就 可 以 直接 访 问 main.js 中 exports 34 RHI AAT. 


有 时 候 我 们 只 是 想 把 一 个 对 象 封装 到 模块 中 ， 格 式 如 下 : 


module.exports = function() { 
V 


} 


例如 : 


//hello.js 
function Hello() { 
varname; 
this.setName = function(thyName) ( 
name = thyName; 


J; 
this.sayHello = function() { 
console.log('Hello ' + name); 


module.exports = Hello; 


这 样 就 可 以 直接 获得 这 个 对 象 了 : 


//main.js 

var Hello - require('./hello'); 
hello - new Hello(); 
hello.setName('BYVoid'); 
hello.sayHello(); 


模块 接口 的 唯一 变化 是 使 用 module.exports = Hello f&& T exports.world = function(){}. 在 
外 部 引用 该 模块 时 ， 其 接口 对 象 就 是 要 输出 的 Hello 对 象 本 身 ， 而 不 是 原先 的 exports, 


服务 端的 模块 放 在 哪里 
也 许 你 已 经 注意 到 ， 我 们 已 经 在 代码 中 使 用 了 模块 了 。 像 这 样 : 
var http = require("http"); 
http.createServer(...); 
Node.js 中 自 带 了 一 个 叫做 "http" 的 模块 ， 我 们 在 我 们 的 代码 中 请 求 它 并 把 返回 值 赋 给 一 个 本 地 
变量 。 
这 把 我 们 的 本 地 变量 变 成 了 一 个 拥有 所 有 http 模块 所 提供 的 公共 方法 的 对 象 。 
Node.js 的 require 方 法 中 的 文件 查找 策略 如 下 : 


由 于 Node.js 中 存在 4 类 模块 (原生 模块 和 3 种 文件 模块 ) ， 尽 管 require 方 法 极其 简单 ， 但 是 内 
部 的 加 载 却 是 十 分 复 条 的 ， 其 加 载 优 先 级 也 各 自 不 同 。 如 下 图 所 示 : 






坦 找 文件 模 
块 


加 载 原生 模块 
根据 扩展 名 载 入 
文件 模块 
缓存 原生 模块 


缓存 文件 模块 


Eu 





返回 exports 


从 文件 模块 缓存 中 加 载 


尽管 原生 模块 与 文件 模块 的 优先 级 不 同 ， 但 是 都 不 会 优先 于 从 文件 模块 的 缓存 中 加 载 已 经 存 
在 的 模块 。 


从 原生 模块 加 载 


原生 模块 的 优先 级 仅 次 于 文件 模块 缓存 的 优先 级 。require 方 法 在 解析 文件 名 之 后 ， 优 先 检查 
模块 是 否 在 原生 模块 列表 中 。 以 http 模 块 为 例 ， 尽 管 在 目录 下 存在 一 个 
http/http.js/http.nodey/http.json 文 件 ，require("http") 都 不 会 从 这 些 文件 中 加 载 ， 而 是 从 原生 模 
块 中 加 载 。 


原生 模块 也 有 一 个 缓存 区 ， 同 样 也 是 优先 从 缓存 区 加 载 。 如 果 缓 存 区 没有 被 加 载 过 ， 则 调用 
原生 模块 的 加 载 方式 进行 加 载 和 执行 。 


从 文件 加 载 


当 文 件 模块 缓存 中 不 存在 ， 而 且 不 是 原生 模块 的 时 候 ， ou Ld a E 
A FMNAFRAPMALSANEA, JD3isfen By eiim 5 TEBU— p hb T2 
过 ， 这 里 我 们 将 详细 描述 查找 文件 模块 的 过 程 ， 其 中 ， 也 有 一 些 细节 值得 知晓 。 


require 方 法 接受 以 下 几 种 参数 的 传递 : 


e http、fs、path 等 ， 原 生 模 块 。 

e ./mod 或 ../mod， 相 对 路 径 的 文件 模块 。 

e /pathtomodule/mod， 绝 对 路 径 的 文件 模块 。 
e mod， 非 原生 模块 的 文件 模块 。 


Node.js 2X 

ftJavaScriptrh, — DKR EAE 25; 3 -NNA 9X dd RIEATEXEGL— TENA, A 
Bese, RIDES 3 22b 75 BREW, 

Node.js Nae Javascript% Ll, GIS, I T EA EM : 


function say(word) ( 
console.log(word); 


function execute(someFunction, value) { 
someFunction(value); 


} 


execute(say, "Hello"); 
以 上 代码 中 ， 我 们 把 say 函数 作为 execute 函 数 的 第 一 个 变量 进行 了 传递 。 这 里 返回 的 不 是 


say 的 返回 值 ， 而 是 say AE ! 


这 样 一 来 ， say 就 变 成 了 execute 中 的 本 地 变量 someFunction ，execute 可 以 通过 调用 
someFunction() 〈 带 括号 的 形式 ) 来 使 用 say MR 


当然 ， 因 为 say 有 一 个 变量 ， execute 在 调用 someFunction 时 可 以 传递 这 样 一 个 变量 。 


匿名 函数 


我 们 可 以 把 一 个 函数 作为 变量 传递 。 但 是 我 们 不 一 定 要 绕 这 个 " 先 定 义 ， 再 传递 "的 圈子 ， 我 们 
可 以 直接 在 另 一 个 函数 的 括号 中 定义 和 传递 这 个 图 数 : 


function execute(someFunction, value) { 
someFunction(value); 


} 


execute(function(word){ console.log(word) }, "Hello"); 


我 们 在 execute 接受 第 一 个 参数 的 地 方 直 接 定义 了 我 们 准 各 传递 给 execute MWR, 
用 这 种 方式 ， 我 们 其 至 不 用 给 这 个 函数 起 名 字 ， 这 也 是 为 什么 它 被 叫做 匿名 男 数 。 


范 数 传递 是 如 何 让 HTTP 服 务 器 工作 的 


着 这 些 知识 ， 我 们 再 来 看 看 我 们 简约 而 不 简单 的 HTTP 服 务 器 : 


都 


var http - require("http"); 


http.createServer(function(request, response) { 
response.writeHead(200, {"Content-Type": "text/plain"}); 
response.write("Hello World"); 
response.end(); 

}).listen(8888) ; 


现在 它 看 上 去 应 该 清晰 了 很 多 : 我 们 向 createServer HAH T — EBB, 


用 这 样 的 代码 也 可 以 达到 同样 的 目的 : 


var http = require("http"); 


function onRequest(request, response) { 
response.writeHead(200, {"Content-Type": "text/plain"}); 
response.write("Hello World"); 
response.end(); 


} 


http.createServer(onRequest).listen(8888); 


Node.js 路 由 


我 们 要 为 路 由 提供 请 求 的 URL 和 其 他 需要 的 GET 及 POST 参数 ， 随 后 路 由 需要 根据 这 些 数据 来 
执行 相应 的 代码 。 


因此 ， 我 们 需要 查看 HTTP 请 求 ， 从 中 提取 出 请 求 的 URL 以 及 GET/POST 参 数 。 这 一 功能 应 当 
属于 路 由 还 是 服务 器 〈 甚 至 作为 一 个 模块 自身 的 功能 ) 确实 值得 探讨 ， 但 这 里 暂 定 其 为 我 们 
的 HTTP 服 务 器 的 功能 。 


我 们 需要 的 所 有 数据 都 会 包含 在 request 对 象 中 ， 该 对 象 作 为 onRequest() 回 调 函 数 的 第 一 个 参 
数 传递 。 但 是 为 了 解析 这 些 数据 ， 我 们 需要 额外 的 Node.JS 模 块 ， 它 们 分 别 是 url 和 querystring 
模块 。 


url.parse(string).query 


url.parse(string).pathname 


| 
querystring(string)["foo"] 


querystring(string)["hello"] 


当然 我 们 也 可 以 用 querystring 模 块 来 解析 POST 请 求 体 中 的 参数 ， 稍 后 会 有 演示 。 


现在 我 们 来 给 onRequest() 画 数 加 上 一 些 逻 辑 ， 用 来 找 出 浏览 器 请 求 的 URL 路 径 : 


var http = require("http"); 
var url = require("ur1"); 


function start() { 
function onRequest(request, response) { 
var pathname - url.parse(request.url).pathname; 
console.log("Request for " + pathname + " received."); 
response.writeHead(200, {"Content-Type": "text/plain"}); 
response.write("Hello World"); 
response.end(); 


} 


http.createServer(onRequest).listen(8888); 
console.log("Server has started."); 


} 


exports.start = start; 


好 了 ， 我 们 的 应 用 现在 可 以 通过 请 求 的 URL 路 径 来 区 别 不 同 请 求 了 -- 这 使 我 们 得 以 使 用 路 由 
(还 未 完成 ) 来 籽 请 求 以 URL 路 径 为 基准 映射 到 处 理 程序 上 。 


在 我 们 所 要 构建 的 应 用 中 ， 这 意味 着 来 自 /start 和 /upload 的 请 求 可 以 使 用 不 同 的 代码 来 处 理 。 
稍 后 我 们 将 看 到 这 些 内 容 是 如 何 整合 到 一 起 的 。 


现在 我 们 可 以 来 编写 路 由 了 ， 建 立 一 个 名 为 router.js 的 文件 ， 添 加 以 下 内 容 : 


function route(pathname) { 
console.log("About to route a request for " + pathname); 


} 


exports.route = route; 


如 你 所 见 ， 这 段 代 码 什么 也 没 干 ， 不 过 对 于 现在 来 说 这 是 应 该 的 。 在 添加 更 多 的 逻辑 以 前 ， 
我 们 先 来 看 看 如 何 把 路 由 和 服务 器 整合 起 来 。 


我 们 的 服务 器 应 当知 道路 由 的 存在 并 加 以 有 效 利用 。 我 们 当然 可 以 通过 硬 编码 的 方式 将 这 一 
依赖 项 绑 定 到 服务 器 上 ， 但 是 其 它 语言 的 编程 经 验 告诉 我 们 这 会 是 一 件 非 常 痛苦 的 事 ， 因 此 
我 们 将 使 用 依赖 注入 的 方式 较 松 散 地 添加 路 由 模块 。 


首先 ， 我 们 来 扩展 一 下 服务 器 的 start() 画 数 ， 以 便 将 路 由 画 数 作 为 参数 传递 过 去 : 


var http = require("http"); 
var url = require("ur1"); 


function start(route) { 
function onRequest(request, response) { 
var pathname = url.parse(request.url).pathname; 
console.log("Request for " + pathname + " received."); 


route(pathname); 
response.writeHead(200, {"Content-Type": "text/plain"}); 
response.write("Hello World"); 


response.end(); 


} 


http.createServer(onRequest).listen(8888); 
console.log("Server has started."); 


} 


exports.start = start; 


lat, RNAs Rindexjs, E44 EH ELI n] BCE A RUBRA ASF : 


var server 
var router 


require("./server"); 
require("./router"); 


server.start(router.route); 


在 这 里 ， 我 们 传递 的 函数 依旧 什么 也 没 做 。 


如 果 现 在 启动 应 用 (node index.js， 始 终 记得 这 个 命令 行 ) ， 随 后 请 求 一 个 URL， 你 将 会 看 到 
应 用 输出 相应 的 信息 ， 这 表明 我 们 的 HTTP 服 务 器 已 经 在 使 用 路 由 模块 了 ， 并 会 将 请 求 的 路 径 
传递 给 路 由 : 


bash$ node index.js 
Request for /foo received. 
About to route a request for /foo 


以 上 输出 已 经 去 掉 了 比较 烦人 的 /favicon.ico 请 求 相 关 的 部 分 。 


Node.js 全 局 对 象 
JavaScript 中 有 一 个 特殊 的 对 象 ， 称 为 全 局 对 象 (Global Object) ， 它 及 其 所 有 属性 都 可 以 
在 程序 的 任何 地 方 访 问 ， 即 全 局 变量 。 


在 浏览 器 JavaScript 中 ， 通 常 window 是 全 局 对 象 ， 而 Node.js 中 的 全 局 对 象 是 global， 所 有 
全 局 变量 (除了 global 本 身 以 外 ) 都 是 global 对 象 的 属性 。 


我 们 在 Node.js 中 能 够 直接 访问 到 对 象 通常 都 是 global 的 属性 ， 如 console, process S, F 
面 逐 一 介绍 。 


全 局 对 象 与 全 局 变量 


global 最 根本 的 作用 是 作为 全 局 变量 的 宿主 。 按 照 ECMAScript 的 定义 ， 满 足以 下 条 件 的 变 
量 是 全 局 变量 : 

e 在 最 外 层 定 义 的 变量 ; 

e 全 局 对 象 的 属性 ; 

e 隐 式 定义 的 变量 (未 定义 直接 赋值 的 变量 ) 。 


当 你 定义 一 个 全 局 变量 时 ， 这 个 变量 同时 也 会 成 为 全 局 对 象 的 属性 ， 反 之 亦 然 。 需 要 注 意 的 
是 ， 在 Node.js 中 你 不 可 能 在 最 外 层 定 义 变 量 ， 因 为 所 有 用 户 代码 都 是 属于 当前 模块 的 ， 而 
模块 本 身 不 是 最 外 层 上 下 文 。 

注意 : 永远 使 用 var 定义 变量 以 避免 引入 全 局 变量 ， 因 为 全 局 变量 会 污染 命名 空间 ， 提 高 代 
码 的 耦合 风险 。 


process 


process 是 一 个 全 局 变量 ， 即 global 对 象 的 属性 。 

它 用 于 描述 当前 Node.js 进程 状态 的 对 象 ， 提 供 了 一 个 与 操作 系统 的 简单 接口 。 通 常 在 你 写 
本 地 命令 行程 序 的 时 候 ， 少 不 了 要 和 它 打 交道 。 下 面 将 会 介绍 process 对 象 的 一 些 最 常用 的 
成 员 方 法 。 


process.argv 是 命令 行 参 数 数 组 ， 第 一 个 元 素 是 node， 第 二 个 元 素 是 脚本 文件 名 ， 从 第 三 个 
元 素 开始 每 个 元 素 是 一 个 运行 参数 。 


console.log(process.argv); 


将 以 上 代码 存储 为 argvjs， 通 过 以 下 命令 运行 : 


$ node argv.js 1991 name-byvoid --v "Carbo Kuo" 
[ 'node', 

'/home/byvoid/argv.js', 

'1991', 

"name=byvoid', 

!'--V', 

"Carbo Kuo' ] 


。 process.stdout 是 标准 输出 流 ， 通 常 我 们 使 用 的 console.log() 向 标准 输出 打印 字符 ， 而 
process.stdout.write() 函数 提供 了 更 底层 的 接口 。 

e process.stdin 是 标准 输入 流 ， 初 始 时 它 是 被 上 暂停 的 ， 要 想 从 标准 输入 读 取 数据 ， 你 必须 
恢复 流 ， 并 手动 编写 流 的 事件 响应 画 数 。 


process.stdin.resume(); 
process.stdin.on('data', function(data) { 
process.stdout.write('read from console: ' + data.toString()); 


3); 


。 process.nextTick(callback) 的 功能 是 为 事件 循环 设置 一 项 任务 ，Node.js 会 在 下 次 事件 
循环 调 响 应 时 调用 callback。 


初学 者 很 可 能 不 理解 这 个 函数 的 作用 ， 有 什么 任务 不 能 在 当下 执行 完 ， 需 要 交 给 下 次 事 件 循 
环 响 应 来 做 呢 ? 


我 们 讨论 过 ，Node.js 适合 I/O 密集 型 的 应 用 ， 而 不 是 计算 密集 型 的 应 用 ， 因为 一 个 Node.js 
进程 只 有 一 个 线程 ， 因 此 在 任何 时 刻 都 只 有 一 个 事件 在 执行 。 


如 果 这 个 事 件 占用 大 量 的 CPU 时 间 ， 执 行事 件 循环 中 的 下 一 个 事件 就 需要 等 竺 很久， 因此 
Node.js 的 一 个 编程 原则 就 是 尽量 缩短 每 个 事件 的 执行 时 间 。process.nextTick() 提供 了 一 个 
这 样 的 工具 ， 可 以 把 复杂 的 工作 拆散 ， 变 成 一 个 个 较 小 的 事件 。 


functiondoSomething(args, callback) { 
somethingComplicated(args); 
callback(); 


doSomething(functiononEnd() { 
compute(); 


3); 


我 们 假设 compute() 和 somethingComplicated() HA 3 A Esp NWR, ME 的 程序 在 调用 
doSomething() 时 会 先 执行 somethingComplicated()， 然 后 立即 调用 [jg EXZX, TE onEnd() 
中 又 会 执行 compute()。 下 面 用 process.nextTick() 改 宇 上 面 的 程序 : 


functiondoSomething(args, callback) { 
somethingComplicated(args); 
process.nextTick(callback); 


doSomething(functiononEnd() { 
compute(); 


3); 


改写 后 的 程序 会 把 上 面 耗 时 的 操作 拆 分 为 两 个 事件 ， 减 少 每 个 事件 的 执行 时 间 ， 提 高 事 件 响 


注意 : 不 要 使 用 setTimeout(fn,0) 代 蔡 process.nextTick(callback)， 前 者 比 后 者 效率 要 低 得 


我 们 探讨 了 process 对 象 常用 的 几 个 成 员 ， 除 此 之 外 process 还 展示 了 process.platform、 
process.pid, process.execPath, process.memoryUsage() 等 方法 ， 以 及 POSIX 进程 信号 响 
应 机 制 。 有 兴趣 的 读者 可 以 访问 http://nodejs.org/api/process.html 了 解 详细 AB. 


console 
console 用 于 提供 控制 台 标 准 输 出 ， 它 是 由 Internet Explorer 的 JScript 引擎 提供 的 调试 工 
具 ， 后 来 逐渐 成 为 浏览 器 的 事实 标准 。 


Node.js 治 用 了 这 个 标准 ， 提 供与 习惯 行为 一 致 的 console 对 象 ， 用 于 向 标准 输出 流 
(stdout) 或 标准 错误 流 (stderr) 输出 字符 。 ? console.log() : 向 标准 输出 流 打 印字 符 并 以 
换行 符 结 


console.log 接受 若干 个 参数 ， 如 果 只 有 一 个 参数 ， 则 输出 这 个 参数 的 字符 串 形 式 。 如 果 有 多 
个 参数 ， 则 以 类 似 于 C 语言 printf() 命令 的 格式 输出 。 


第 一 个 参数 是 一 个 字符 种， 如 果 没 有 参数 ， 只 打印 一 个 换行 。 


console.log('Hello world'); 
console.log('byvoid%diovyb' ); 
console.log('byvoid%diovyb', 1991); 


运行 结果 为 : 


Hello world 
byvoid%diovyb 
byvoidi991iovyb 


e console.error() : &console.log() 用 法 相同 ， 只 是 向 标准 错误 流 输 出 。 
e console.trace() : 向 标准 错误 流 输 出 当前 的 调用 栈 。 


console.trace(); 


运行 结果 为 : 


Trace: 


at 
at 
at 
at 
at 
at 
at 


Object.«anonymous» (/home/byvoid/consoletrace.js:1:71) 
Module. compile (module.js:441:26) 

Object..js (module.js:459:10) 

Module.load (module.js:348:31) 

Function. load (module.js:308:12) 

Array.0 (module.js:479:10) 

EventEmitter. tickCallback (node.js:192:40) 


Node.js ®FAALS util 


util 是 一 个 Node.js 核心 模块 ， 提 供 常 用 函数 的 集合 ， 用 于 弥补 核心 JavaScript 的 功能 过 于 精 
简 的 不 足 。 


util.inherits 


util.inherits(constructor, superConstructor) 是 一 个 实现 对 象 间 原 型 继承 的 函数 。 


JavaScript 的 面向 对 象 特性 是 基于 原型 的 ， 与 常见 的 基于 类 的 不 同 。JavaScript 没有 提供 对 
象 继 承 的 语言 级 别 特性 ， 而 是 通过 原型 复制 来 实现 的 。 


在 这 里 我 们 只 介绍 utilinherits 的 用 法 ， 示 例如 下 : 


varutil = require('util'); 
functionBase() { 
this.name - 'base'; 
this.base - 1991; 
this.sayHello = function() { 
console.log('Hello ' + this.name); 


T 
} 


Base.prototype.showName = function() { 
console.log(this.name); 
HN 


functionSub() { 
this.name - 'sub'; 


util.inherits(Sub, Base); 
varobjBase - newBase(); 
objBase.showName(); 
objBase.sayHello(); 
console.log(objBase); 
varobjSub - newSub(); 
objSub.showName( ) ; 
//objSub.sayHello(); 
console.log(objSub); 


我 们 定义 了 一 个 基础 对 象 Base ee 的 Sub，Base 有 三 个 在 构造 男 数 内 定义 的 
属性 和 一 个 原型 中 定义 的 函数 ， 通 过 util.inherits 实现 继承 。 运 行 结果 如 下 : 


base 

Hello base 

{ name: 'base', base: 1991, sayHello: [Function] } 
sub 


{ name: 'sub' } 


注意 : Sub 仅仅 继承 了 Base TEIER Zi rRzE SLBSERZA, MERRER base 属 性 和 
sayHello HAARA Sub 继承 。 


同时 ， 在 原型 中 定义 的 属性 不 会 被 console.log F 为 对 象 的 属性 输出 。 如 果 我 们 去 掉 
objSub.sayHello(); 这 行 的 注释 ， 将 会 看 到 : 


node.js:201 
throw e; // process.nextTick error, or 'error' event on first tick 
^ 


TypeError: Object #<Sub> has no method 'sayHello' 

at Object.«anonymous» (/home/byvoid/utilinherits.js:29:8) 
at Module. compile (module.js:441:26) 

at Object..js (module.js:459:10) 

at Module.load (module.js:348:31) 

at Function. load (module.js:308:12) 

at Array.0 (module.js:479:10) 

at EventEmitter. tickCallback (node.js:192:40) 


util.inspect 


util.inspect(object,[showHidden],[depth],[colors]) 是 一 个 将 任意 对 象 转换 为 字符 串 的 方法 ， 通 
常用 于 调试 和 错误 输出 。 它 至 少 接受 一 个 参数 object， 即 要 转换 的 对 象 。 


showHidden 是 一 个 可 选 参 数 ， 如 果 值 为 true， 将 会 输出 更 多 隐藏 信息 。 


depth 表示 最 大 递归 的 层 数 ， 如 果 对 象 很 复 厅 ， 你 可 以 指定 层 数 以 控制 输出 信息 的 多 少 。 如 
果 不 指定 depth， a cm ， 指 定 为 null Z&zr RES BR 3S 3 BBs. WRcolor 
f& 7j true, i MESI DLANSI 颜色 编码 ， 通 常用 于 在 终端 显示 更 漂亮 的 效果 。 


特别 要 指出 的 是 ，util.inspect 并 不 会 简单 地 直接 把 对 象 转 换 为 字符 串 ， 即 使 该 对 象 定义 了 
toString 方法 也 不 会 调用 。 


varutil = require('util'); 
functionPerson() { 
this.name - 'byvoid'; 
this.toString = function() { 
return this.name; 


T 
} 


varobj = newPerson(); 
console.log(util.inspect(obj)); 
console.log(util.inspect(obj, true)); 


运行 结果 是 : 


{ name: 'byvoid', toString: [Function] } 

{ toString: 

{ [Function] 

[prototype]: { [constructor]: [Circular] }, 
[caller]: null, 

[length]: 0 

[name]: '', 

[arguments]: null }, 

name: 'byvoid' } 


util.isArray(object) 


如 果 给 定 的 参数 "object" 是 一 个 数组 返回 true， 否 则 返回 false。 


var util = require('util'); 


util.isArray([]) 

// true 
util.isArray(new Array) 

// true 
util.isArray({}) 

// false 


util.isRegExp(object) 
如 果 给 定 的 参数 "object" 是 一 个 正则 表达 式 返回 true， 否 则 返回 false。 


var util = require('util'); 


util.isRegExp(/some regexp/) 
// true 

util.isRegExp(new RegExp('another regexp')) 
// true 

util.isRegExp({}) 
// false 


util.isDate(object) 


如 果 给 定 的 参数 "object" 是 一 个 日 期 返回 true， 否 则 返回 false。 


var util = require('util'); 


util.isDate(new Date()) 

// true 
util.isDate(Date()) 

// false (without 'new' returns a String) 
util.isDate({}) 

// false 


util.isError(object) 


MRAENSR "object" 是 一 个 错误 对 象 返 回 true， 否 则 返回 false。 


var util - require('util'); 


util.isError(new Error()) 


// true 

util.isError(new TypeError()) 
// true 

util.isError(( name: 'Error', message: 'an error occurred' }) 
// false 


更 多 详情 可 以 访问 http://nodejs.org/api/util.html 了 解 详 细 内 容 。 


Node.js 文件 系统 


Node.js 提供 一 组 类 似 UNIX (POSIX) 标准 的 文件 操作 API。 Node 导入 文件 系统 模块 (fs) 语 
法 如 下 所 示 : 


var fs = require("fs") 


异步 和 同步 


Node.js 文件 系统 (fs 模块 ) 模块 中 的 方法 均 有 异步 和 同步 版 本 ， 例 如 读 取 文件 内 容 的 画 数 有 
异步 的 fs.readFile() 和 同步 的 fs.readFileSync()。 


异步 的 方法 函数 最 后 一 个 参数 为 回调 范 数 ， 回 调 函 数 的 第 一 个 参数 包含 了 错误 信息 (error)。 
建议 大 家 是 用 异步 方法 ， 比 起 同步 ， 异 步 方 法 性 能 更 高 ， 速 度 更 快 ， 而 且 没有 阻塞 。 


实例 
创建 input.txt 文件 ， 内 容 如 下 : 


菜 乌 教程 官网 地 址 : www.runoob .com 
文件 读 取 实例 


创建 file.js 文件 , 代码 如 下 : 


var fs = require("fs"); 


// 异步 读 取 
fs.readFile('input.txt', function (err, data) { 
if (err) { 
return console.error(err); 


console.1og(" 异 步 读 取 : " + data.toString()); 
15 
// 同步 读 取 
var data = fs.readFileSync('input.txt'); 
console.1og(" 同 步 读 取 : " + data.toString()); 


mh 


console .10g( "程序 执行 完毕 。")， 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
同步 读 取 :; 菜 乌 教 程 官网 地 址 : www.runoob .com 
文件 读 取 实 例 


程序 执行 完毕 。 
异步 读 取 : 菜 乌 教程 官网 地 址 : www.runoob.com 
文件 读 取 实例 


接 下 来 ， 让 我 们 来 具体 了 解 下 Node.js 文件 系统 的 方法 。 


打开 文件 


语法 
以 下 为 在 异步 模式 下 打开 文件 的 语法 格式 : 


fs.open(path, flags[, mode], callback) 


参数 
参数 使 用 说 明 如 下 : 
e path - 文件 的 路 径 。 


e flags - 文件 打开 的 行为 。 具 体 值 详 见 下 文 。 
e mode - 设置 文件 模式 (权限 )， 文 件 创建 默认 权限 为 0666( 可 读 ， 可 写 )。 
e callback - [533 E323, 5883 98 1 2230 : callback(err, fd). 


flags 参数 可 以 是 以 下 值 : 


Flag 描述 


r 以 读 取 模 式 打开 文件 。 如 果 文 件 不 存在 抛 出 异常 。 

r+ 以 读 写 模式 打开 文件 。 如 果 文 件 不 存在 抛 出 异常 。 

rs 以 同步 的 方式 读 取 文 件 。 

re* 以 同步 的 方式 读 取 和 写 和 人 文件 。 

w 以 写 入 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

WX 类 似 'w'， 但 是 如 果 文 件 路 径 不 存在 ， 则 文件 写 入 失败 。 
w+ 以 读 写 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

WX+ 类 似 wee, 但 是 如 果 文 件 路 径 不 存在 ， 则 文件 读 写 失败 。 
a 以 追加 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

ax 类 似 'a， 但 是 如 果 文 件 路 径 不 存在 ， 则 文件 追加 失败 。 
at 以 读 取 追 加 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 


ax+ 类 似 'a+'， 但 是 如 果 文 件 路 径 不 存在 ， 则 文件 读 取 追 加 失败 。 


实例 
接 下 来 我 们 创建 flejs 文件 ， 并 打开 input.txt 文件 进行 读 写 ， 代 码 如 下 所 示 : 


var fs = require("fs"); 
// 异步 打开 文件 
console.10g(" 准 各 打开 文件 1 "); 
fs.open('input.txt', 'r+', function(err, fd) { 
if (err) { 
return console.error(err); 


} 
console.1og(" 文 件 打开 成 功 1"); 
3); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
准备 打开 文件 ! 
文件 打开 成 功 ! 


获取 文件 信息 


语法 


以 下 为 通过 异步 模式 获取 文件 信息 的 语法 格式 : 


fs.stat(path, callback) 


参数 使 用 说 明 如 下 : 
e path - 文件 路 径 。 
e callback - 回调 本 数 ， 带 有 两 个 参数 如 : (err, stats), stats 是 fs.Stats 对 象 。 


fs.stat(path) 执 行 后 ， 会 将 stats 类 的 实例 返回 给 其 回调 函数 。 可 以 通过 stats 类 中 的 提供 方法 判 
断 文 件 的 相关 属性 。 例 如 判断 是 否 为 文件 : 


var fs = require('fs'); 


fs.stat('/Users/liuht/code/itbilu/demo/fs.js', function (err, stats) ( 


console.log(stats.isFile()); //true 
3) 
stats 类 中 的 方法 有 : 
方法 描述 
stats.isFile() 如 果 是 文件 返回 true, FARE false. 
stats.isDirectory() 如 果 是 目录 返回 true, FURE false. 
stats.isBlockDevice() 如 果 是 块 设备 返回 true, AIRE) false. 


stats.isCharacterDevice() ” 如果 是 字符 设备 返回 true， 否 则 返回 false. 


stats.isSymbolicLink() 如 果 是 软 链接 返回 true, AIRE false. 
; 如 果 是 FIFO， 返 回 true， 否 则 返回 false, FIFOZEUNIXHRBS 
Ss nene 一 种 特殊 类 型 的 命 全 管道 。 
stats.isSocket() 如 果 是 Socket 返回 true， 否 则 返回 false. 
实例 
头 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs - require("fs"); 


console. log("#4H FAM ! "); 
fs.stat('input.txt', function (err, stats) { 
if (err) { 
return console.error(err); 
j 


console.log(stats); 
console .1l0g(" 读 取 文 件 信 息 成 功 ! "); 


// 检测 文件 类 型 
console.log( "是 否 为 文件 (isFile) ? " + stats.isFile()); 
console .10g( "是否 为 目录 (isDirectory) ? " + stats.isDirectory()); 


}); 





以 上 代码 执行 结果 如 下 : 


$ node file.js 
准备 打开 文件 ! 
{ dev: 16777220, 
mode: 33188, 
nlink: 1, 
uid: 501, 
gid: 20, 
rdev: 0, 
blksize: 4096, 
ino: 40333161, 
size: 61, 
blocks: 8, 
atime: Mon Sep 07 2015 17:43:55 GMT+0800 (CST), 
mtime: Mon Sep 07 2015 17:22:35 GMT+0800 (CST), 
ctime: Mon Sep 07 2015 17:22:35 GMT+0800 (CST) } 
读 取 文 件 信 息 成 功 ! 
是 否 为 文件 (isFile) ? true 
是 否 为 目录 (isDirectory) ? false 


= 

BAM 

语法 

以 下 为 异步 模式 下 写 入 文件 的 语法 格式 : 
fs.writeFile(filename, data[, options], callback) 


如 果 文 件 存 在 ， 该 方法 写 和 人 的 内 容 会 覆盖 旧 的 文件 内 容 。 


参数 
参数 使 用 说 明 如 下 : 
e path - 文件 路 径 。 
。 data - 要 写 入 文件 的 数据 ， 可 以 是 String( 字 符 串 ) 或 Buffer( 流 ) 对 象 。 


e options - 该 参数 是 一 个 对 象 ， 包 含 {encoding, mode, flag}。 默 认 编 码 为 utf8, 模式 为 
0666, flag 为 'w' 


e callback - [573 E42, [GE ij EX2UR 81 44x fe B 2X (err), TELA Ac o gl. 


实例 
接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"); 


console.1og(" 准 备 写 入 文件 " ) ; 
fs.writeFile('input.txt', 我 是 通过 写 入 的 文件 内 容 ! '， function(err) { 
if (err) { 
return console.error(err); 


j 
console. log( "数据 写 入 成 功 ! "); 
console.log("-------- 我 是 分 割 线 ------------- y 
console.1og(" 读 取 写 入 的 数据 1") ; 
fs.readFile('input.txt', function (err, data) ( 
if (err) { 
return console.error(err); 


} 

console.10g(" 异 步 读 取 文 件数 据 : " + data.toString()); 
}); 
H; 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 写 入 文件 

数据 写 入 成 功 ! 

-------- REDER- ------------ 

读 取 写 入 的 数据 ! 

异步 读 取 文 件数 据 : 我 是 通过 写 入 的 文件 内 容 


st 
读 取 文件 
语法 
以 下 为 异步 模式 下 读 取 文件 的 语法 格式 : 
fs.read(fd, buffer, offset, length, position, callback) 


该 方法 使 用 了 文件 描述 符 来 读 取 文 件 。 


参数 


参数 使 用 说 明 如 下 : 


e fd - 通过 fs.open() 方法 返回 的 文件 描述 符 。 
。 buffer - 数据 写 入 的 缓冲 区 。 

。 offset - 缓冲 区 写 入 的 宇 入 偏 移 量 。 

。 length - 要 从 文件 中 读 取 的 字 节 数 。 


e position - 文件 读 取 的 起 始 位 置 ， 如 果 position 的 值 为 null， 则 会 从 当前 文件 指针 的 位 置 
读 取 。 


e callback - 回调 函数 ， 有 三 个 参数 err, bytesRead, buffer, err 为 错误 信息 ， bytesRead 
表示 读 取 的 字 节 数 ，buffer 为 缓冲 区 对 象 。 


实例 
input.txt 文件 内 容 为 : 


菜 乌 教程 官网 地 址 : www.runoob.com 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"); 
var buf = new Buffer(1024); 


console.1log(" 准 各 打开 已 存在 的 文件 1 " ) ; 
fs.open('input.txt', 'r+', function(err, fd) { 
if (err) { 
return console.error(err); 


j 
console. log("XFH FAR | "); 
console.1og(" 准 备 读 取 文 件 : " ) ; 
fs.read(fd, buf, ©, buf.length, ©, function(err, bytes){ 
if (err){ 
console.log(err); 


console.log(bytes + " 字 节 被 读 取 ")，; 


// 仅 输 出 读 取 的 字 节 
if(bytes > 0){ 

console.log(buf.slice(0, bytes).toString()); 
} 


)y 
2); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 打开 已 存在 的 文件 ! 

文件 打开 成 功 ! 

准 各 读 取 文件 : 

42 ” 字 节 被 读 取 

菜 乌 教程 官网 地 址 : www.runoob.com 


天 闭 文 件 

语法 

以 下 为 异步 模式 下 关闭 文件 的 语法 格式 : 
fs.close(fd, callback) 


该 方法 使 用 了 文件 描述 符 来 读 取 文 件 。 


参数 
参数 使 用 说 明 如 下 : 
e fd- 通过 fs.open() 方法 返回 的 文件 描述 符 。 


e callback - 回调 画 数 ， 没 有 参数 。 


实例 
input.txt 文件 内 容 为 : 


菜 乌 教程 官网 地 址 : www.runoob.com 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs - require("fs"); 
var buf - new Buffer(1024); 


console. log("#447 FAX !"); 
fs.open('input.txt', 'r+', function(err, fd) { 
if (err) { 
return console.error(err); 
j 


console. log( "文件 打开 成 功 ! "); 
console.1log(" 准 各 读 取 文 件 1"); 
fs.read(fd, buf, ©, buf.length, ©, function(err, bytes){ 
if (err){ 
console.log(err); 
} 


// 仅 输 出 读 取 的 字 节 
if(bytes > 0)( 

console.log(buf.slice(0, bytes).toString()); 
} 


// 关闭 文件 

fs.close(fd, function(err){ 

if (err){ 
console.log(err); 

} 

console. log( "EK i KI"); 

3); 
3); 

3); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 打开 文件 ! 

文件 打开 成 功 ! 

准备 读 取 文件 ! 

菜 乌 教程 官网 地 址 : www.runoob.com 
文件 关闭 成 功 


截取 文件 

语法 

以 下 为 异步 模式 下 截取 文件 的 语法 格式 : 
fs.ftruncate(fd, len, callback) 


该 方法 使 用 了 文件 描述 符 来 读 取 文 件 。 


参数 
参数 使 用 说 明 如 下 : 


e fd- 通过 fs.open() 方法 返回 的 文件 描述 符 。 


。 len - 文件 内 容 截 取 的 长 度 。 


e callback - [8133 Eq42&, SABAL 


实例 
input.txt 文件 内 容 为 : 


site:www.runoob.com 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"); 
var buf = new Buffer(1024); 


console.1og(" 准 备 打开 文件 1 "); 
fs.open('input.txt', 'r+', function(err, fd) { 
if (err) { 
return console.error(err); 
j 


console. log( "文件 打开 成 功 ! "); 
console.1lo0g( "截取 10 字 节 后 的 文件 内 容 。" ) ; 


// 截取 文件 
fs.ftruncate(fd, 10, function(err){ 
if (err){ 
console.log(err); 
} 


console.1og(" 文 件 截取 成 功 。" ) ; 
console.1og(" 读 取 相同 的 文件 " ) ; 
fs.read(fd, buf, ©, buf.length, ©, function(err, bytes){ 
if (err){ 
console.log(err); 
} 


// 仅 输出 读 取 的 字 节 
if(bytes > O){ 

console.log(buf.slice(0, bytes).toString()); 
} 


// 关闭 文件 
fs.close(fd, function(err){ 
if (err){ 
console.log(err); 


} 
console.1log( "文件 关闭 成 功 ! "); 
3); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 打开 文件 ! 

文件 打开 成 功 ! 

截取 10 字 节 后 的 文件 内 容 。 
文件 截取 成 功 。 

读 取 相同 的 文件 
site:www.r 


文件 关闭 成 功 


删除 文件 


Lr 
以 下 为 删除 文件 的 语法 格式 : 


fs.unlink(path, callback) 


参数 使 用 说 明 如 下 : 
e path - 文件 路 径 。 


e callback - 回调 函数 ， 没 有 参数 。 


实例 
input.txt 文件 内 容 为 : 


site:www.runoob.com 


接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"); 


console.1og(" 准 各 删除 文件 1 "); 
fs.unlink('input.txt', function(err) ( 
if (err) { 
return console.error(err); 


} 
console.1og(" 文 件 删除 成 功 1"); 
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以 上 代码 执行 结果 如 下 : 


$ node file.js 
准备 删除 文件 | 
文件 删除 成 功 ! 


再 去 查看 input.txt 文件 ， 发 现 已 经 不 存在 了 。 


创建 目录 


语法 
以 下 为 创建 目录 的 语法 格式 : 


fs.mkdir(path[, mode], callback) 


参数 使 用 说 明 如 下 : 
e path - 文件 路 径 。 
。 mode - 设置 目录 权限 ， 黑 认为 0777。 


e callback - EAK, SABR 


实例 
接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"); 





console.1og( 创 建 目录 /tmp/test"); 
fs.mkdir('/tmp/test',function(err)( 
if (err) { 
return console.error(err); 


} 
console.1og(" 目 录 创 建成 功 。" ) ; 
3; 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
创建 目录 /tmp/test 
目录 创建 成 功 。 








读 取 目录 


语法 
以 下 为 读 取 目 录 的 语法 格式 : 


fs.readdir(path, callback) 


参数 使 用 说 明 如 下 : 
e path - 文件 路 径 。 


e callback - 回调 画 数 ， 回 调 罚 数 带 有 两 个 参数 err, files, err 为 错误 信息 ，files 为 目录 下 
的 文件 数组 列表 。 


实例 
接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"); 


console.log(" 查 看 /tmp Ex"); 
fs.readdir("/tmp/",function(err, files){ 
if (err) { 
return console.error(err); 


} 
files.forEach( function (file)f{ 
console.log( file ); 
H); 
3) 


以 上 代码 执行 结果 如 下 : 


$ node file.js 
查看 /tmp 目录 
input.out 
output.out 
test 

test.txt 


删除 目录 


语法 
以 下 为 删除 目录 的 语法 格式 : 


fs.rmdir(path, callback) 


参数 使 用 说 明 如 下 : 
e path - 文件 路 径 。 


e callback - 回调 函数 ， 没 有 参数 。 


实例 
接 下 来 我 们 创建 file.js 文件 ， 代 码 如 下 所 示 : 


var fs = require("fs"); 


console,1og(" 准 备 删 除 目录 /tmp/test"); 
fs.rmdir("/tmp/test", function(err){ 
if (err) { 
return console.error(err); 


j 
console.log("izHX /tmp Bx"); 
fs.readdir("/tmp/",function(err, files){ 
if (err) { 
return console.error(err); 


files.forEach( function (file){ 
console.log( file ); 


P) 
3); 


以 上 代码 执行 结果 如 下 : 


$ node file.js 

准备 删除 目录 /tmp/test 
input.out 

output.out 

test 

test.txt 

读 取 /tmp 目录 


文件 模块 方法 参考 手册 


以 下 为 Node.js 文件 模块 相同 的 方法 列表 : 


方法 描述 
rne 异步 rename) BARRASA, (LAA. 
newPath, callback) 
fs.ftruncate(fd, len, = ftruncate().[B 3 ER24& 8 224, (BARE E 
callback) Fo 


fs.ftruncateSync(fd, len) 同步 ftruncate() 


fs.truncate(path, len, 
callback) 


fs.truncateSync(path, len) 


fs.chown(path, uid, gid, 
callback) 


fs.chownSync(path, uid, 
gid) 


fs.fchown(fd, uid, gid, 
callback) 


fs.fchownSync(fd, uid, gid) 


fs.Ichown(path, uid, gid, 
callback) 


fs.IlchownSync(path, uid, 
gid) 


fs.chmod(path, mode, 
callback) 


fs.chmodSync(path, mode) 


fs.fchmod(fd, mode, 
callback) 


fs.fchmodSync(fd, mode) 


fs.Ichmod(path, mode, 
callback) 


fs.IchmodSync(path, mode) 


fs.stat(path, callback) 


fs.Istat(path, callback) 


fs.fstat(fd, callback) 


fs.statSync(path) 
fs.IstatSync(path) 
fs.fstatSync(fd) 


fs.link(srcpath, dstpath, 
callback) 


fs.linkSync(srcpath, 
dstpath) 


fs.symlink(srcpath, 


同步 truncate() 


异步 chown().[B 33 «2305883 2:24, (AAMAS. 
同步 chown() 


4; fchown().[Bl3 ERU 234, (ARM Sa. 


yu 


可 


同步 fchown() 


异步 Ichown(). 回 调 玉 数 没有 参数 ， 但 可 能 抛 出 异常 。 
同步 Ichown() 


异步 chmod(). 回 调 范 数 没 有 参数 ， 但 可 能 抛 出 异常 。 
同步 chmod(). 
异步 frhmod(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 


同步 fchmod(). 


异步 Ichmod(). 回 调 画 数 没有 参数 ， 但 可 能 抛 出 异常 。 
Only available on Mac OS X. 


同步 Ichmod(). 


异步 stat(). 回调 函数 有 两 个 参数 err stats, stats 是 
fs.Stats 对 象 。 


52 Istat(). 回调 函数 有 两 个 参数 err stats, stats 是 
fs.Stats 对 象 。 


异步 fstat(). 回调 函数 有 两 个 参数 err, stats, stats 是 
fs.Stats 对 象 。 


同步 stat(). 返回 fs.Stats 的 实例 。 
同步 lstat(). 返回 fs.Stats 的 实例 。 
同步 fstat(). 返回 fs.Stats 的 实例 。 


异步 link(). 回 调 男 数 没有 参数 ， 但 可 能 抛 出 异常 。 


同步 link(). 


异步 symlink(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 
type 参数 可 以 设置 为 'dir' ‘file’, SX 'junction' (默认 为 


fs.symlinkSync(srcpath, 
dstpath[, type]) 


fs.readlink(path, callback) 


fs.realpath(path[, cache], 
callback) 


fs.realpathSync(path[, 
cache]) 


fs.unlink(path, callback) 
fs.unlinkSync(path) 
fs.rmdir(path, callback) 
fs.rmdirSync(path) 


fs.mkdir(path[, mode], 
callback) 


fs.mkdirSync(path[, mode]) 
fs.readdir(path, callback) 
fs.readdirSync(path) 
fs.close(fd, callback) 
fs.closeSync(fd) 


fs.open(path, flags[, mode], 
callback) 


fs.openSync(path, flags[, 
mode]) 


fs.utimes(path, atime, 
mtime, callback) 


fs.utimesSync(path, atime, 
mtime) 


fs.futimes(fd, atime, mtime, 
callback) 


fs.futimesSync(fd, atime, 
mtime) 


fs.fsync(fd, callback) 
fs.fsyncSync(fd) 


fs.write(fd, buffer, offset, 
length[, position], callback) 


fs.write(fd, data[, position[, 


file") o 
同步 symlink(). 


异步 readlink(). 回调 函数 有 两 个 参数 err, linkString. 


52 realpath(). 回调 函数 有 两 个 参数 err, 


resolvedPath。 


异步 unlink(). 回 调 函 数 没 有 参数 ， 但 可 能 抛 出 异常 。 


( 

同步 unlink(). 
异步 rmdir(). 回 调 函 数 没 有 参数 ， 但 可 能 抛 出 异常 。 

同步 rmdir(). 


S 异 步 mkdir(2). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 
mode defaults to 0777. 


同步 mkdir(). 

异步 readdir(3). 读 取 目录 的 内 容 。 

同步 readdir(). 返 回 文件 数组 列表 。 

异步 close(). 回 调 本 数 没有 参数 ， 但 可 能 抛 出 异常 。 
同步 close(). 


异步 打开 文件 。 


同步 version of fs.open(). 


修改 文件 时 间 戳 ， 文 件 通过 指定 的 文件 路 径 。 


修改 文件 时 间 戳 ， 通 过 文件 描述 符 指定 。 


异步 fsync. 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 
同步 fsync. 


将 缓冲 区 内 容 写 入 到 通过 文件 描述 符 指 定 的 文件 。 


通过 文件 描述 符 fd 写 入 文件 内 容 。 


encoding]], callback) 


fs.writeSync(fd, buffer, 
offset, length[, position]) 


fs.writeSync(fd, data[, 
position[, encoding]]) 


fs.read(fd, buffer, offset, 
length, position, callback) 


fs.readSync(fd, buffer, 
offset, length, position) 


fs.readFile(filename[, 
options], callback) 


fs.readFileSync(filename[, 
options]) 


fs.writeFile(filename, data[, 
options], callback) 


fs.writeFileSync(filename, 
data[, options]) 


fs.appendFile(filename, 
data[, options], callback) 


fs.appendFileSync(filename, 
data[, options]) 


fs.watchFile(filename[, 
options], listener) 


fs.unwatchFile(filename[, 
listener]) 


fs.watch(filename[, options] 
[, listener]) 


fs.exists(path, callback) 
fs.existsSync(path) 


fs.access(path[, mode], 
callback) 


fs.accessSync(path[, 
mode]) 


fs.createReadStream(path[, 
options]) 


fs.createWriteStream(path[, 
options]) 


fs.symlink(srcpath, 


通过 文件 描述 符 fd 写 入 文件 内 容 。 


同步 版 的 fs.write(). 


同步 版 的 fs.write(). 


通过 文件 描述 符 fd 读 取 文件 内 容 。 


同步 版 的 fs.read. 


异步 读 取 文件 内 容 。 
异步 写 入 文件 内 容 。 


同步 版 的 fs.writeFile。 
异步 追加 文件 内 容 。 

The 同步 version of fs.appendFile. 
查看 文件 的 修改 。 


停止 查看 filename 的 修改 。 


查看 filename 的 修改 ，filename 可 以 是 文件 或 目录 。 
返回 fs.FSWatcher 对 象 。 


伟 测 给 定 的 路 径 是 否 存 在 。 


同步 版 的 fs.exists. 


测试 指定 路 径 用 户 权 限 。 
同步 版 的 fs.access。 

返回 ReadStream 对 象 。 
返回 WriteStream 对 象 。 


异步 symlink(). 回 调 函 数 没有 参数 ， 但 可 能 抛 出 异常 。 


更 多 内 容 ， 请 查看 官网 文件 模块 描述 : File System. 


Node.js GET/POSTia 3K 


在 很 多 场景 中 ， 我 们 的 服务 器 都 需要 跟 用 户 的 浏览 器 打交道 ， 如 表单 提交 。 
表单 提交 到 服务 器 一 般 都 使 用 GET/POST 请 求 。 


本 章节 我 们 将 为 大 家 介绍 Node.js GET/POST 请 求 。 


获取 GET 请 求 内 容 


由 于 GET 请 求 直接 被 嵌入 在 路 笃 中 ，URL 是 完整 的 请 求 路 笃 ， 包 括 了 ?后 面 的 部 分 ， 因 此 你 可 
以 手动 解析 后 面 的 内 容 作为 GET 请 求 的 参数 。 


node.js 中 url 模 块 中 的 parse 函 数 提供 了 这 个 功能 。 


var http = require('http'); 
var url = require('ur1'); 
var util = require('util'); 


http.createServer(function(req, res){ 
res.writeHead(200, {'Content-Type': 'text/plain'}); 
res.end(util.inspect(url.parse(req.url, true))); 
}).listen(3000) ; 


在 浏览 器 中 访 问 http://localhost:3000/user?name-w3c&email-w3cQw3cschool.cc 然后 查看 返回 


结 未 : 


{ protocol: null, 
slashes: null, 
auth: null, 
host: null, 
port: null, 
hostname: null, 
hash: null, 
search: ' ?name=w3chemail=w3c@w3cschool. cc’, 
query: { name: 'w3c', email: ’w3c@w3cschool.cc’ }, 
pathname: '/user', 
path: '/user?name-w3c&email-w3ciw3cschool. cc’, 
href: '/user?name-w3c&email-w3cüw3cschool.cc' } 


获取 POST 请 求 内 容 


POST 请 求 的 内 容 全 部 的 都 在 请 求 体 中 ，http.ServerRequest 并 没有 一 个 属性 内 容 为 请 求 体 ， 
原因 是 等 待 请 求 体 传 输 可 能 是 一 件 耗 时 的 工作 。 


比如 上 传 文件 ， 而 很 多 时 候 我 们 可 能 并 不 需要 理会 请 求 体 的 内 容 ， 恶 意 的 POST 请 求 会 大 大 消 
耗 服务 器 的 资源 ， 所 有 node.js 默 认 是 不 会 解析 请 求 体 的 ， 当 你 需要 的 时 候 ， 需 要 手动 来 做 。 


var http = require('http'); 
var querystring = require('querystring'); 
var util = require('util'); 


http.createServer(function(req, res){ 
var post = ''; // 定 义 了 一 个 post 变 量 ， 用 于 暂 存 请 求 体 的 信息 


req.on('data', function(chunk){ // 通 过 reqd 的 data 事 件 监听 函数 ， 每 当 接 受到 请 求 体 的 数据 ， 就 累 力 
post += chunk; 
}); 


req.on('end', function(){ // 在 end 事 件 触发 后 ， 通 过 querystring.parse 将 post 解 析 为 真正 的 POS 
post = querystring.parse(post); 
res.end(util.inspect(post)); 
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)).listen(3000); 


1 - 





Node.js 工具 模块 


在 Node.js 模块 库 中 有 很 多 好 用 的 模块 。 接 下 来 我 们 为 大 家 介绍 几 种 常用 模块 的 使 用 : 


模块 名 
OS 模块 
Path 模块 
Net 模块 
DNS 模块 


Domain 模块 


描述 
提供 基本 的 系统 操作 男 数 。 
提供 了 你 理 和 转换 文件 路 的 工具 。 
用 于 底层 的 网 络 通信 。 提 供 了 服务 端 和 客户 端的 的 操作 。 
用 于 解析 域名 。 
简化 异步 代码 的 异常 人 处理， 可 以 捕捉 处 理 try catch 无 法 捕捉 的 。 


Node.js OS 模块 


Node.js os R H jelk T -HBAND RARER. RTAMRA FARSA AR : 


var os = require("os") 


方法 


方法 描述 
os.tmpdir() 返回 操作 系统 的 默认 临时 文件 夹 。 
os.endianness() 返回 CPU 的 字 节 序 ， 可 能 的 是 "BE" g "LE". 
os.hostname() 返回 操作 系统 的 主机 名 。 
os.type() 返回 操作 系统 名 
os.platform() 返回 操作 系统 名 
«cn anie CPU 架构 ， 可 能 的 值 有 "x64", "arm" 和 
os.release() 返回 操作 系统 的 发 行 版 本 。 
os.uptime() 返回 操作 系统 运行 的 时 间 ， 以 秒 为 单位 。 
os.loadavg() 返回 一 个 包含 1、5、15 分 钟 平均 负载 的 数组 。 
os.totalmem() 返回 系统 内 存 总 量 ， 单 位 为 字 节 。 
os.freemem() 返回 操作 系统 空闲 内 存量 ， 单 位 是 字 节 。 

返回 一 个 对 象 数组 ， 包 含 所 安装 的 每 个 CPU/ 内 核 的 信息 : 型 

os.cpus() 号 、 速 度 (单位 MHz) 、 时 间 (一 个 包含 user、nice、 


sys, idle 和 irq 所 使 用 CPU/ 内 核 毫 秒 数 的 对 象 )。 
os.networkinterfaces() ”获得 网 络 接口 列表 。 


属性 


属性 描述 
os.EOL 定义 了 操作 系统 的 行 尾 符 的 常量 。 


实例 


创建 main.js 文件 ， 代 码 如 下 所 示 : 


var os = require("os"); // CPU 的 字 节 序 console.log('endianness : ' + os.endianness()); 
‘| DU 
代码 执行 结果 如 下 : 








$ node main.js 

endianness : LE 

type : Linux platform : linux 

total memory : 25103400960 bytes. free memory : 20676710400 bytes. 


Node.js Path 模块 


Node.js path 模块 提供 了 一 些 用 于 处 理 文件 路 径 的 小 工具 ， 我 们 可 以 通过 以 下 方式 引入 该 模 
块 : 


var path = require("path") 


方法 


方法 描述 
path.normalize(p) 规范 化 路 径 ， 注 意 … AL". 
path.join([path1][, 用 于 连接 路 径 。 该 方法 的 主要 用 途 在 于 ， 会 正确 使 用 当前 系 
path2][ ...]) 统 的 路 径 分 隔 符 ，Unix 系 统 是 ""，Windows 系 统 是 "\"。 
poinresolvellfrom =b 将 to 参数 解析 为 绝对 路 径 。 
path.isAbsolute(path) 判断 参数 path 是 否 是 绝对 路 径 。 


path.relative(from, to) 用 于 将 相对 路 径 转 为 绝对 路 径 。 


返回 路 径 中 代表 文件 夹 的 部 分 ， 同 Unix 的 dirname 命令 类 

似 。 

path.basename(p[, ext) ”返回 路 径 中 的 最 后 一 部 分 。 同 Unix 命令 bashname 类 似 。 
返回 路 径 中 文件 的 后 级 名 ， 即 路 径 中 最 后 一 个 '.' 之 后 的 部 

path.extname(p) 分 。 如 果 一 个 路 径 中 并 不 包含 '' 或 该 路 径 只 包含 一 个 ".' BR 
个 '. 为 路 径 的 第 一 个 字符 ， 则 此 命令 返回 空 字 符 串 。 

path.parse(pathString) 返回 路 径 字 符 串 的 对 象 。 

path.format(pathObject) ”从 对 象 中 返回 路 径 字 符 串 ， 和 path.parse 相反 。 


path.dirname(p) 


属性 


属性 描述 
path.sep 平台 的 文件 路 径 分 隔 符 ，\ 或 /。 
path.delimiter 平台 的 分 隔 符 , ; or ". 
path.posix 提供 上 述 path 的 方法 ， 不 过 总 是 以 posix 兼容 的 方式 交互 。 
path.win32 提供 上 述 path 的 方法 ， 不 过 总 是 以 win32 兼容 的 方式 交互 。 


实例 


创建 main.js 文件 ， 代 码 如 下 所 示 : 


var path = require("path"); 


// 格式 化 路 径 


console.log('normalization : ' + path.normalize('/test/testi1//2slashes/1slash/tab/..')); 


// 连接 路 径 
console.log('joint path : ' + path.join('/test', 'testi', '2slashes/islash', 'tab', '..') 


// 转换 为 绝对 路 径 
console.log('resolve : ' + path.resolve('main.js')); 


// 路 径 中 文件 的 后 级 名 


console.log('ext name : ' + path.extname('main.js')); 
SSS 
代码 执行 结果 如 下 : 





$ node main.js 

normalization : /test/testi/2slashes/islash 
joint path : /test/testi1/2slashes/1slash 
resolve : /web/com/1427176256 27423/main.js 
ext name : .js 


Node.js Net 模块 


Node.js Net 模块 提供 了 一 些 用 于 底层 的 网 络 通信 的 小 工具 ， 包 含 了 创建 服务 器 /客户 端的 方 
法 ， 我 们 可 以 通过 以 下 方式 引入 该 模块 : 


var net = require("net") 


方法 


方法 描述 
net.createServer([options][, 创建 一 个 TCP 服务 器 。 参 数 connectionListener Bl 
connectionListener]) 3h25 'connection' 事件 创建 监听 器 。 


返回 一 个 新 的 'net.Socket'， 并 连接 到 指定 的 地 址 和 


net.connect(options[, P uy bis abo oum ` 
connectionListener]) 2x 34 socket 建立 的 时 候 ， 将 会 触发 'connect 


net.createConnection(options[， ”创建 一 个 到 端口 port 和 主机 host 的 TCP 连接 。 


connectionListener]) host 默认 为 localhost'。 

创建 一 个 端口 为 port 和 主机 为 host 的 TCP 连接 。 
net.connect(port[, host][, host 默认 为 localhost'。 参 数 connectListener 将 会 
connectListener]) 作为 监听 器 添加 到 'connect' 事件。 返回 


'net.Socket', 


创建 一 个 端口 为 port 和 主机 为 host 的 TCP 连接 。 


net.createConnection(port[， host 默认 为 localhost'。 参 数 connectListener 将 会 
host][, connectListener]) 作为 监听 器 添加 到 'connect' 事件。 返回 


'net.Socket', 


创建 连接 到 path 的 unix socket, BA 
Dey cone cn pat connectListener 将 会 作为 监听 器 添加 到 "connect 
connectListener]) 事件 上 EH ‘net Socket 


创建 连接 到 path 的 unix socket, BR 


net.createConnection(path[, connectListener 将 会 作为 监听 器 添加 到 'connect' 





CODEC Hn 事件 。 返 回 'net.Socket'. 

net.isIP(input) se RUA TN EET IPV4 返回 4, IPV6 
net.isIPv4(input) pore IPV4, 返回 true， 否 则 返回 
net.isIPv6(input) AR NUES IPV6, 返回 true, AAEE 


net.Server 


net.Server 通 常用 于 创建 一 个 TCP 或 本 地 服务 器 。 


方法 


server.listen(port[, host][, 
backlog][, callback]) 


server.listen(path[, callback]) 


server.listen(handle[, callback]) 


server.listen(options[, callback]) 


server.close([callback]) 


server.address() 


server.unref() 


server.ref() 


server.getConnections(callback) 


描述 


监听 指定 端口 port 和 主机 host ac 连接 。 默认 情 
况 下 host 接受 任何 IPv4 地 址 (INADDR_ANY) 的 
直接 连接 。 端 口 port 为 0 时 ， 则 会 分 配 一 个 随机 
端口 。 


通过 指定 path 的 连接 ， 和 启动 一 个 本 地 socket 服务 
E 


通过 指定 句柄 连接 。 


options 的 属性 : 端口 port, 主机 host, 和 backlog, 
以 及 可 选 参数 callback HR, 他 们 在 一 起 调用 
server.listen(port, [host], [backlog], [callback])。 还 
A, $3X path 可 以 用 来 指定 UNIX socket. 


服务 器 停止 接收 新 的 连接 ， 保 持 现 有 连接 。 这 是 异 
步 画 数 ， 当 所 有 连接 结束 的 时 候 服 务 器 会 关闭 ， 并 
会 触发 'close' 事件 。 


操作 系统 返回 绑 定 的 地 址 ， 协 议 族 名 和 服务 器 端 
Els 


如 果 这 是 事件 系统 中 唯一 一 个 活动 的 服务 器 ， 调 用 
unref 将 允许 程序 退出 。 


与 unref 相反 ， 如 果 这 是 唯一 的 服务 器 ， 在 之 前 被 
unref 了 的 服务 器 上 调用 ref 将 不 会 让 程序 退出 
(默认 行为 ) 。 如 果 服 务 器 已 经 被 ref， 则 再 次 调 
用 ref 并 不 会 产生 影响 。 


异步 获取 服务 器 当前 活跃 连接 的 数量 。 当 socket 
发 送 给 子 进程 后 地 有 效 ; 回调 函数 有 2 个 参数 err 
和 count。 


事件 
事件 描述 
listening 当 服 务 器 调用 server.listen 绑 定 后 会 触发 。 


connection ” 当 新 连接 创建 后 会 被 触发 。socket 是 net.Socket 实 例 。 
服务 器 关闭 时 会 触发 。 注 意 ， 如 果 存 在 连接 ， 这 个 事件 不 会 被 触发 直到 所 


cose 有 的 连接 关闭 。 


error 发 生 错误 时 触发 。'close' 事件 将 被 下 列 事件 直接 调用 。 


net.Socket 


net.Socket x1 Æ TCP 或 UNIX Socket 的 抽象 。net.Socket 实例 实现 了 一 个 双 工 流 接口 。 
他 们 可 以 在 用 户 创建 客户 端 (使 用 connect()) 时 使 用 , 或 者 由 Node 创建 它们 ， 并 通过 
connection 服务 器 事件 传递 给 用 户 。 


事件 
net.Socket 事件 有 : 
事件 描述 
lookup 在 解析 域名 后 ， 但 在 连接 前 ， 触 发 这 个 事件 。 对 UNIX sokcet 不 适用 。 
connect ”成 功 建立 socket 连接 时 触发 。 
data 当 接 收 到 数据 时 触发 。 
end 当 socket 另 一 端 发送 FIN 包 时 ， 触 发 该 事件 。 
mecut = socket ZE Wanike, LERH socket 已 经 空闲 。 用 户 必须 手动 关闭 
连接 。 
drain 当 写 缓存 为 空 得 时 候 触 发 。 可 用 来 控制 上 传 。 
error 错误 发 生 时 触发 。 
EE 4 socket 完全 关闭 时 触发 。 参 数 had error 是 布尔 值 ， 它 表示 是 否 因为 传输 
错误 导致 socket 关闭 。 
属性 
net.Socket 提供 了 很 多 有 用 的 属性 ， 便 于 控制 socket 交互 : 
属性 描述 
socket.bufferSize 该 属性 显示 了 要 写 入 缓冲 区 的 字 节 数 。 


socket.remoteAddress 


远程 的 IP 地 址 字符 串 ， 例 如 : '74.125.127.100' or 
'2001:4860:23005::68', 


socket.remoteFamily 远程 IP 协 议 族 字 符 串 ， 比 如 "IPv4' or 'IPv6'. 


socket.remotePort 远程 端口 ， 数 字 表 示 ， 例 如 : 80 or 21。 


网 络 连 接线 定 的 本 地 接口 远程 客户 端正 在 连接 的 本 地 IP 地 


socket.localAddress 址 ， 字 符 串 表示 。 人 例如， 如果 你 在 监听 '0.0.0.0' 而 客户 端 连 接 


在 '192.168.1.1'， 这 个 值 就 会 是 '192.168.1.1'。 


socket.localPort 本 地 端口 地 址 ， 数 字 表 示 。 例 如 : 80 or 21。 
socket.bytesRead 接收 到 得 字 节 数 。 
socket.bytesWritten 发 送 的 字 节 数 。 
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Node.js Net 模块 101 


方法 


new net.Socket([options]) 


socket.connect(port[, host][, 
connectListener]) 


socket.connect(path[, 
connectListener]) 


socket.setEncoding([encoding]) 


socket.write(data[, encoding][, 
callback]) 


socket.end([data][, encoding]) 


socket.destroy() 


socket.pause() 


socket.resume() 


socket.setTimeout(timeout[, 
callback]) 


socket.setNoDelay([noDelay]) 


socket.setKeepAlive([enable][, 
initialDelay]) 


socket.address() 


socket.unref() 


socket.ref() 


描述 
构造 一 个 新 的 socket 对 象 。 


指定 端口 port 和 主机 host， 创 建 socket 连接 。 
参数 host 默认 为 localhost。 通 常情 况 不 需要 使 用 
net.createConnection 打开 socket。 只 有 你 实现 了 
自己 的 socket 时 才 会 用 到 。 


打开 指定 路 径 的 unix socket。 通 常情 况 不 需要 使 
用 net.createConnection 打开 socket。 只 有 你 实现 
了 自己 的 socket 时 才 会 用 到 。 


Bas 


f£ socket 上 发 送 数据 。 第 二 个 参数 指定 了 字符 串 
的 编码 ， 默 认 是 UTF8 编码 。 


半 关 闭 socket。 例 如 ， 它 发 送 一 个 FIN 包 。 可 能 
服务 器 仍 在 发 送 数 据 。 


确保 没有 VO 活动 在 这 个 套 接 字 上 。 只 有 在 错误 发 
生 情 况 下 才 需 要 。 (义理 错误 等 等 ) 。 


暂停 读 取 数据 。 就 是 说 ， 不 会 再 触发 data 事件 。 
对 于 控制 上 传 非常 有 用 。 


调用 pause() 后 想 恢 复读 取 数 据 。 


socket 闲置 时 间 超 过 
设置 为 超时 。 


禁用 纳 格 (Nagle) 算法 。 默 认 情况 下 TCP 连接 使 
用 纳 格 算法 ， 在 发 送 前 他 们 会 缓冲 数据 。 将 
noDelay 设置 为 true 将 会 在 调用 socket.write() 时 
立即 发 送 数据 。noDelay 默认 值 为 true, 


禁用 /启用 长 连接 功能 ， 并 在 发 送 第 一 个 在 闲置 
socket 上 的 长 连接 probe 之 前 ， 可 选 地 设 定 初 始 
Ento MA X falses 设 定 initialDelay (BY) , 
来 设 定 收 到 的 最 后 一 个 数据 包 和 第 一 个 长 连接 
probe 之 间 的 延 时 。 将 initialDelay 设 为 0， 将 会 保 
AA (或 者 之 前 ) 的 值 。 默 认 值 为 0. 


操作 系统 返回 绑 定 的 地 址 ， 协 议 族 名 和 服务 器 端 
口 。 返 回 的 对 象 有 3 个 属性 ， 比 如 { port: 12346, 
family: 'IPv4', address: '127.0.0.1' Y. 


如 果 这 是 事件 系统 中 唯一 一 个 活动 的 服务 器 ， 调 用 
unref 将 允许 程序 退出 。 如 果 服 务 器 已 被 unref， 则 
再 次 调用 unref 并 不 会 产生 影响 。 


与 unref 相反 ， 如 果 这 是 唯一 的 服务 器 ， 在 之 前 被 
unref 了 的 服务 器 上 调用 ref 将 不 会 让 程序 退出 

(默认 行为 ) 。 如 果 服 务 器 已 经 被 ref， 则 再 次 调 
用 ref 并 不 会 产生 影 响 。 


timeout 毫秒 后 ， 将 socket 


实例 
创建 server.js 文件 ， 代 码 如 下 所 示 : 


var net = require('net'); 

var server = net.createServer(function(connection) { 
console.log('client connected'); 
connection.on('end', function() { 

console.1og(' 客 户 端 关闭 连接 ' ) ; 

1); 
connection.write('Hello World!\r\n'); 
connection.pipe(connection); 

15 

server.listen(8080, function() { 
console.log('server is listening'); 


3); 


执行 以 上 服务 端 代码 : 


$ node server.js 
server is listening # 服务 已 创建 并 监听 8080 端口 


新 开 一 个 窗口 ， 创 建 client.js 文件 ， 代 码 如 下 所 示 : 


var net = require('net'); 

var client = net.connect({port: 8080}, function() { 
console. log( ' 连 接 到 服务 器 ! '); 

3) 

client.on('data', function(data) { 
console.log(data.toString()); 
client.end(); 


3); 


client.on('end', function() { 
console.1og( ' 断 开 与 服务 器 的 连接 ' ) ; 
15 


执行 以 上 客户 端的 代码 : 
连接 到 服务 器 ! 
Hello World! 


断 开 与 服务 器 的 连接 


Gif 实例 演示 
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Ber net = require('net'); 
var server = net.createServer(function(connection) { 
console. log('client connected'); 
connection.on('end', function() 1 
console.log('X P x Bldg '); 
); 
connection.write('Hello World!\r\n'); 
connection.pipe(connection); I 
}); 
server.listen(8080, function() { 
console.log('server is listening'); 
); 


. node — vim — 80x24 


? 749299012312 


'server.js" 12L, 357C 
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Node.js DNS 模块 


Node.js DNS 模块 用 于 解析 域名 。 引 入 DNS 模块 语法 格式 如 下 : 


var dns = require("dns") 


方法 


方法 


dns.lookup(hostname[, 
options], callback) 


dns.lookupService(address, 
port, callback) 


dns.resolve(hostname[, 
rrtype], callback) 


dns.resolve4(hostname, 
callback) 


dns.resolve6(hostname, 
callback) 


dns.resolveMx(hostname, 
callback) 


dns.resolveTxt(hostname, 
callback) 


dns.resolveSrv(hostname, 
callback) 


dns.resolveSoa(hostname, 
callback) 


dns.resolveNs(hostname, 
callback) 


dns.resolveCname(hostname, 
callback) 


dns.reverse(ip, callback) 
dns.getServers() 


dns.setServers(servers) 


rrtypes 


描述 


将 域名 (比如 'runoob.com') 解析 为 第 一 条 找到 的 记 
X A (IPVA) 或 AAAA(IPV6)。 参 数 options 可 以 是 
一 个 对 象 或 整数 。 如 果 没 有 提供 options, IP v4 和 
v6 地 址 都 可 以 。 如 果 options 是 整数 ， 则 必须 是 4 或 
6。 


使 用 getnameinfo 解析 传人 的 地 址 和 端口 为 域名 和 服 
务 。 


将 一 个 域名 (如 'runoob.com') 解析 为 一 个 rrtype 18 
定 记 录 类 型 的 数组 。 


和 dns.resolve() 类 似 , 仅 能 查询 IPv4 (A 记录 ) o 
addresses IPv4 地 址 数组 (比如 ，[74.125.79.104'， 
'74.125.79.105', '74.125.79.106']) 。 


和 dns.resolve4() #14, 仅 能 查询 IPv6( AAAA & 


询 ) 


和 dns.resolve() 类 似 , 仅 能 查询 邮件 交换 (MX 记 
3f )o 


和 dns.resolve() 类 似 , 仅 能 进行 文本 查询 (TXT 记 
录 ) 。 addresses 是 2-d 文本 记录 数组 。( 比 如 ，[ 
[v=spf1 ip4:0.0.0.0 , '~all ] ]) 。 每 个 子 数组 包含 一 
条 记录 的 TXT 块 。 根 据 使 用 情况 可 以 连接 在 一 起 ， 
也 可 单独 使 用 。 


和 dns.resolve() 类 似 , 仅 能 进行 服务 记录 查询 (SRV 
记录 ) o addresses 是 hostname 可 用 的 SRV 记录 
数组 。 SRV 记录 属性 有 优先 级 (priority) ， 权 重 
(weight) mO (port) , #4 (name) (比如 ， 
[(priority': 10, 'weight': 5, 'port': 21223, 'name" 
'service.example.com", ...]) o 


和 dns.resolve() 2 (Ll, 仅 能 查询 权威 记录 (SOA iz 
录 ) 。 


和 dns.resolve() 类 似 , 仅 能 进行 域名 服务 器 记录 查询 
(NS 记录 ) 。 addresses 是 域名 服务 器 记录 数组 

(hostname 可 以 使 用 ) (比如 , ['ns1.example.com’, 
'ns2.example.com']) 。 


和 dns.resolve() 类 似 , 仅 能 进行 别名 记录 查询 
(CNAME 记 录 )。addresses 是 对 hostname 可 用 的 别 
名 记录 数组 (比如 ，, ['bar.example.com']) 。 


反 向 解析 IP 地 址 ， 指 向 该 IP 地 址 的 域名 数组 。 
返回 一 个 用 于 当前 解析 的 IP 地 址 数组 的 字符 串 。 
指定 一 组 IP 地 址 作为 解析 服务 器 。 


以 下 列 出 了 dns.resolve() 方法 中 有 效 的 rrtypes (a: 


'A'. IPV4 地 址 , 默认 
'AAAA' IPV6 地 址 

MX 邮件 交换 记录 

'TxT' text 记录 

'SRV' SRV 记录 

'PTR' ARRA IP. 查找 
'ws' 域名 服务 器 记录 
'CNAME' 别名 记录 

'soa' 授权 记录 的 初始 值 


错误 码 


每 次 DNS 查询 都 可 能 返回 以 下 错误 码 : 


dns.NODATA : 无 数据 响应 。 

dns.FORMERR : 查询 格式 错误 。 

dns.SERVFAIL : 常规 失败 。 

dns.NOTFOUND : 没有 找到 域名 。 

dns.NOTIMP : 未 实现 请 求 的 操作 。 
dns.REFUSED : 拒绝 查询 。 

dns.BADQUERY : 查询 格式 错误 。 

dns.BADNAME : 域名 格式 错误 。 

dns.BADFAMILY : 地 址 协议 不 支持 。 
dns.BADRESP : 回复 格式 错误 。 
dns.CONNREFUSED : 无 法 连接 到 DNS 服务 器 。 
dns.TIMEOUT : 连接 DNS 服务 器 超时 。 
dns.EOF : 文件 末端 。 

dns.FILE : 读 文件 错误 。 

dns .NOMEM : 内 存 浴 出 。 

dns.DESTRUCTION : 通道 被 摧毁 。 

dns.BADSTR : 字符 串 格 式 错误 。 

dns .BADFLAGS : 非法 标识 符 。 

dns.NONAME : 所 给 主机 不 是 数字 。 

dns .BADHINTS : 非法 HINTS 标 识 符 。 
dns.NOTINITIALIZED : C C-ares 库 尚 未 初始 化 。 
dns.LOADIPHLPAPI : 加 载 iphlpapi.dll 出 错 。 
dns .ADDRGETNETWORKPARAMS : 无 法 找到 GetNetworkParams RX. 
dns.CANCELLED : 取消 DNS 查询 。 


实例 
创建 main.js 文件 ， 代 码 如 下 所 示 : 


var dns = require('dns'); 


dns.lookup('www.github.com', function onLookup(err, address, family) ( 
console.log('ip idbib:', address); 
dns.reverse(address, function (err, hostnames) ( 
if (err) { 
console.log(err.stack); 
j 


console.1og(' 反 向 解析 ' + address + ': ' + JSON.stringify(hostnames)); 
15 
15 
执行 以 上 代码 ， 结 果 如 下 所 示 : 


address: 192.30.252.130 
reverse for 192.30.252.130: ["github.com"] 


Node.js Domain 模块 


Node.js Domain( 域 ) 简化 异步 代码 的 异常 处 理 ， 可 以 捕捉 处 理 try catch 无 法 捕捉 的 异常 。 引 
入 Domain 模块 语法 格式 如 下 : 


var domain = require("domain") 


domain 模 块 ， 把 处 理 多 个 不 同 的 IO 的 操作 作为 一 个 组 。 注 册 事 件 和 回调 到 domain， 当 发 生 一 
个 错误 事件 或 抛 出 一 个 错误 时 ，domain 对 象 会 被 通知 ， 不 会 丢失 上 下 文 环境 ， 也 不 导致 程序 
错误 立即 推出 ， 和 与 process.on('uncaughtException') 不 同 。 

Domain 模块 可 分 为 隐 式 绑 定 和 显 式 绑 定 : 


e KRAE: 把 在 domain 上 下 文中 定义 的 变量 ， 自 动 绑 定 到 domain 对 象 
e FARE: 把 不 是 在 domain 上 下 文中 定义 的 变量 ， 以 代码 的 方式 绑 定 到 domain 对 象 


方法 


方法 描述 


在 域 的 上 下 文 运行 提供 的 函数 ， 隐 式 的 绑 定 了 所 有 的 事 
件 分 发 器 ， 计 时 器 和 底层 请 求 。 


domain.run(function) 


domain.add(emitter) 显 式 的 增加 事件 
domain.remove(emitter) 删除 事件 。 

返回 的 函数 是 一 个 对 于 所 提供 的 回调 函数 的 包装 本 数 。 
domain.bind(callback) 当 调 用 这 个 返回 的 函数 被 时 ， 所 有 被 抛 出 的 错误 都 会 被 


导向 到 这 个 域 的 error 事件 。 


和 domain.bind(callback) 类 似 。 除 了 捕捉 被 抛 出 的 错误 
外 ， 它 还 会 拦截 Error 对 象 作为 参数 传递 到 这 个 画 数 。 


domain.enter() 进入 一 个 异步 调用 的 上 下 文 ， 绑 定 到 domain。 


退出 当前 的 domain， 切 换 到 不 同 的 链 的 异步 调用 的 上 下 
文中 。 对 应 domain.enter()。 


domain.intercept(callback) 


domain.exit() 


domain.dispose() 释放 一 个 domain 对 象 ， 让 node 进 程 回 收 这 部 分 资源 。 
domain.create() 返回 一 个 domain 对 象 。 


属性 


属性 描述 
domain.members 已 加 入 domain 对 象 的 域 定时 器 和 事件 发 射 器 的 数组 。 


实例 
创建 main.js 文件 ， 代 码 如 下 所 示 : 


var EventEmitter = require("events").EventEmitter; 
var domain - require("domain"); 


var emitter1 = new EventEmitter(); 


// 创建 域 


var domain1 = domain.create(); 


domaini.on('error', function(err){ 
console.log("domaini 处 理 这 个 错误 ("terr.message+")"); 


}); 


// BABE 
domaini.add(emitter1); 


emitter1.on('error', function(err){ 
console.10og(" 监 听 器 义理 此 错误 ("t+terr.message+")"); 


1); 

emitteri.emit('error',new Error(' 通 过 监听 器 来 人 处理 ' ) ); 
emitteri.removeAllListeners('error'); 
emitteri.emit('error',new Error(' 通 过 domaini 义理 ' ) ); 
var domain2 = domain.create(); 


domain2.on('error', function(err){ 
console.log("domain2 义理 这 个 错误 ("+err.message+")"); 


3); 


// 隐 式 绑 定 

domain2.run(function(){ 
var emitter2 = new EventEmitter(); 
emitter2.emit('error',new Error(' 通 过 domain2 4438')); 


3); 


domaini.remove(emitter1); 
emitteri.emit('error', new Error(' 转 换 为 异常 ， 系 统 将 崩 演 !')); 


执行 以 上 代码 ， 结 果 如 下 所 示 : 


监听 器 处 理 此 错误 (通过 监听 器 来 处 理 ) 
domaini 人 处理 这 个 错误 (通过 domaini 4438) 
domain2 人 处理 这 个 错误 (通过 domain2 处 理 ) 


events.js:72 
throw er; // Unhandled 'error' event 
^ 
Error: 转换 为 异常 ， 系 统 将 崩溃 ! 
at Object.«anonymous» (/www/node/main.js:40:24) 
at Module. compile (module.js:456:26) 
at Object.Module. extensions..js (module.js:474:10) 
at Module.load (module.js:356:32) 
at Function.Module. load (module.js:312:12) 
at Function.Module.runMain (module.js:497:10) 
at startup (node.js:119:16) 
at node.js:929:3 
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Node.js Web 模块 


什么 是 Web 服务 器 ? 


Web 服 务 器 一 般 指 网 站 服务 器 ， 是 指 驻 留 于 因特网 上 某 种 类 型 计算 机 的 程序 ，Web 服 务 器 的 
基本 功能 就 是 提供 Web 信 息 浏 览 服务 。 它 只 需 支 持 HTTP 协 议 、HTML 文 档 格 式 及 URL， 与 客 
户 端的 网 络 浏览 器 配合 。 


大 多 数 web 服务 器 都 支持 服务 端的 脚本 语言 (php. python, ruby) 等 ， 并 通过 脚本 语言 从 
数据 库 获取 数据 ， 将 结果 返回 给 客户 端 浏 览 器 。 


目前 最 主流 的 三 个 Web 服 务 器 是 Apache、Nginx、1IS。 


Web 应 用 架构 


Business i Data Layer | 
Layer 


E 
Í 
E223 


Client | Server 




















e Client - 客户 端 ， 一 般 指 浏 览 器 ， 浏 览 器 可 以 通过 HTTP 协议 向 服务 器 请 求 数 据 。 


e Server - 服务 端 ， 一 般 指 Web 服务 器 ， 可 以 接收 客户 端 请 求 ， 并 向 客户 端 发 送 响应 数 
据 。 


e Business - 业务 层 ， 通过 Web 服务 器 义理 应 用 程序 ， 如 与 数据 库 交 互 ， 逻 辑 运算 ， 调 
用 外 部 程序 等 。 


e Data - 数据 层 ， 一 般 由 数据 库 组 成 。 


使 用 Node 创建 Web 服务 器 


Node.js 提供 了 http 232, http 模块 主要 用 于 搭建 HTTP. 服务 端 和 客户 端 ， 使 用 HTTP 服务 
器 或 客户 端 功能 必须 调用 http 模块 ， 代 码 如 下 : 
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var http = require('http'); 


以 下 是 演示 一 个 最 基本 的 HTTP 服务 器 架构 (使 用 8081 端 口 )， 创 建 serverjs 文件 ， 代 码 如 下 
所 示 : 


var http = require('http'); 
var fs - require('fs'); 
var url = require('url'); 


// 创建 服务 器 
http.createServer( function (request, response) { 
// 解析 请 求 ， 包 括 文 件 名 


var pathname = url.parse(request.url).pathname; 


// 输出 请 求 的 文件 名 


console.log("Request for " + pathname + " received."); 


// 从 文件 系统 中 读 取 请 求 的 文件 内 容 
fs.readFile(pathname.substr(1), function (err, data) ( 
if (err) { 
console.log(err); 
// HTTP 状态 码 : 404 : NOT FOUND 
// Content Type: text/plain 
response.writeHead(404, {'Content-Type': 'text/html'}); 
selsef{ 
// HTTP 状态 码 : 200 : OK 
// Content Type: text/plain 
response.writeHead(200, {'Content-Type': 'text/html'}); 


// 响应 文件 内 容 
response.write(data.toString()); 


} 
// ”发 送 响应 数据 
response.end(); 
3); 
}).listen(8081) ; 


// 控制 台 会 输出 以 下 信息 
console.log('Server running at http://127.0.0.1:8081/'); 


接 下 来 我 们 在 该 目录 下 创建 一 个 index.htm 文件 ， 代 码 如 下 : 


«html» 

«head» 

<title>Sample Page</title> 
</head> 

<body> 

Hello World! 

</body> 

</html> 


执行 server.js 文件 : 


$ node server.js 
Server running at http://127.0.0.1:8081/ 


接着 我 们 在 浏览 器 中 打开 地 址 : http://127.0.0.1:8081/index.htm， 显 示 如 下 图 所 示 : 
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Hello World! 


执行 serverjs 的 控制 台 输 出 信息 如 下 : 


Server running at http://127.0.0.1:8081/ 
Request for /index.htm received. # 客户 端 请 求 信息 


B3 node 一 bash — 80x24 








使 用 Node 创建 Web & P im 
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Node 创建 Web 客户 端 需要 引入 http 模块 ， 创 建 client.js 文件 ， 


«pre» 
var http = require('http'); 


// 用 于 请 求 的 选项 

var options = { 
host: 'localhost', 
port: '8081', 
path: '/index.htm' 


H 


// 处 理 响 应 的 回调 函数 
var callback = function(response) { 
// 不 断 更 新 数据 


var body = ''; 


response.on('data', function(data) { 


body += data; 
}); 


response.on('end', function() { 
// 数据 接收 完成 
console.log(body); 


; ye 
// 向 服务 端 发 送 请 求 


var req = http.request(options, callback); 


req.end(); 


新 开 一 个 终端 ， 执 行 clientjs 文件 ， 输 出 结果 如 下 : 


$ node client ,js 

«html» 

«head» 

<title>Sample Page</title> 
</head> 

<body> 

Hello World! 

</body> 

</html> 


执行 server.js 的 控制 台 输 出 信息 如 下 : 


Server running at http://127.0.0.1: 


Request for /index.htm received. 


8081/ 
# 客户 端 请 求 信息 


代码 如 下 所 示 : 
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.. node — node — 80x24 


tiangixindeMacBook-Pro:node tiangixin$ vim server.js 
tiangixindeMacBook-Pro:node tiangixin$ vim index.htm 
tiangixindeMacBook-Pro:node tiangixin$ node server.js 

Server running at http://127.0.0.1:8081/ 

| Request for /index.htm received. 

| Request for /favicon.ico received. 

| ( [Error: ENOENT, open 'favicon.ico'] errno: 34, code: 'ENOENT', path: 'favicon. 
ico' ) 

| Request for /index.htm received. 
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Node.js Express 框架 


Express 简介 
Express 是 一 个 简洁 而 灵活 的 node.js Web 应 用 框架 , 提供 了 一 系列 强大 特性 帮助 你 创建 各 种 
Web 应 用 ， 和 丰富 的 HTTP 工具 。 
使 用 Express 可 以 快速 地 搭建 一 个 完整 功能 的 网 站 。 
Express 框架 核心 特性 : 
。 可 以 设置 中 间 件 来 响应 HTTP 请 求 。 
。 定义 了 路 由 表 用 于 执行 不 同 的 HTTP 请 求 动作 。 


。 可 以 通过 向 模板 传递 参数 来 动态 泻 染 HTML 页 面 。 


安装 Express 
安装 Express 并 将 其 保存 到 依赖 列表 中 : 


$ npm install express --Save 


以 上 命令 会 将 Express 框架 安装 在 当期 目录 的 node. modules 目录 中 ， node modules E 
录 下 会 自动 创建 express 目录 。 以 下 几 个 重要 的 模块 是 需要 与 express 框架 一 起 安装 的 : 


e body-parser - node js Fh jg fF, AFRI JSON, Raw, Text 和 URL 编码 的 数据 。 


e cookie-parser - 这 就 是 一 个 解析 Cookie 的 工具 。 通 过 req.cookies 可 以 取 到 传 过 来 的 
cookie， 并 把 它们 转 成 对 象 。 


e multer - node.js 中 间 件 ， 用 于 人 处理 enctype="multipart/form-data" (设置 表单 的 MIME 编 
码 ) 的 表单 数据 。 


npm install body-parser --save 
npm install cookie-parser --save 
npm install multer --save 


RAHA 


第 一 个 Express 框架 实例 


接 下 来 我 们 使 用 Express 框架 来 输出 "Hello World"。 


以 下 实例 中 我 们 引入 了 express 模块 ， 并 在 客户 端 发 起 请 求 后 ， 
创建 express_demo.js 文件 ， 代 码 如 下 所 示 : 


//express demo.js 文件 
var express - require('express'); 
var app = express(); 


app.get('/', function (req, res) { 
res.send('Hello World'); 
3) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console.log("SA6l, iz jb http://%s:%s", host, port) 
3) 


执行 以 上 代码 : 


$ node express demo.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http:/127.0.0.1:8081， 结 果 如 下 图 所 示 : 


响应 "Hello World" 字符 串 。 
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Hello World 


请 求 和 响应 


Express 应 用 使 用 回调 函数 的 参数 : request 和 response 对 象 来 处 理 请 求 和 响应 的 数据 。 





app.get('/', function (req, res) { 
// -- 


}) 


request 和 response 对 象 的 具体 介绍 : 


Request 对 象 - request 对 象 表示 HTTP 请 求 ， 包 含 了 请 求 查询 字符 串 ， 参 数 ， 内 容 ，HTTP 
头 部 等 属性 。 常 见 属性 有 : 


1. req.app : 当 callback 为 外 部 文件 时 ， 用 req.app 访 问 express 的 实例 
2. req.baseUrl : 获取 路 由 当前 安装 的 URL 路 径 

3. req.body / req.cookies : 获得 DARE] / Cookies 

4. req.fresh / req.stale : 判断 请 求 是 否 还 「 新 鲜 」 

5. req.hostname / req.ip : 获取 主机 名 和 IP 地 址 

6. req.originalUrl : 获取 原始 请 求 URL 

7. req.params : 获取 路 由 的 parameters 

8. req.path : 获取 请 求 路 径 

9. req.protocol : 获取 协议 类 型 

10. req.query : 获取 URL 的 查询 参数 串 

11. req.route : 获取 当前 匹配 的 路 由 

12. req.subdomains : 获取 子 域名 

13. req.accpets () : 检查 请 求 的 Accept 头 的 请 求 类 型 

14. req.acceptsCharsets / req.acceptsEncodings / req.acceptsLanguages 
15. req.get () : 获取 指定 的 HTTP 请 求 头 

16. req.is () : 判断 请 求 头 Content-Type 的 MIME 类 型 


Response 对 象 - response 对 象 表示 HTTP 响应 ， 即 在 接收 到 请 求 时 向 客户 端 发 送 的 HTTP 
响应 数据 。 常 见 属性 有 : 


. res.app : 同 req.app 一 样 

. res.append () : 追加 指定 HTTP 头 

. res.set () 在 res.append () 后 将 重 置 之 前 设置 的 头 
. res.cookie (name, value[, option] : 设置 Cookie 


. res.clearCookie () : 清除 Cookie 
. res.download () : 传送 指定 路 径 的 文件 
. res.get () : 返回 指定 的 HTTP 头 
. resjson () : 传送 JSON 响 应 
10. res.jsonp () : 传送 JSONP 响 应 
11. res.location () : 只 设置 响应 的 Location HTTP 头 ， 不 设置 状态 码 或 者 close response 
12. res.redirect () : 设置 响应 的 Location HTTP 头 ， 并 且 设 置 状 态 码 302 
13. res.send () : 传送 HTTP 响 应 
14. res.sendFile (path [，options] [, fn]) : 传送 指定 路 径 的 文件 -会 自动 根据 文件 


1 
2 
3 
4 
5. opition: domain / expires / httpOnly / maxAge / path / secure / signed 
6 
7 
8 
9 


extension; xE Content-Type 
15. res.set () : 设置 HTTP 头 ， 传 人 object 可 以 一 次 设置 多 个 头 
16. res.status () : 设置 HTTP 状 态 码 
17. res.type () : 设置 Content-Type 的 MIME 类 型 


路 由 


我 们 已 经 了 解 了 HTTP 请 求 的 基本 应 用 ， 而 路 由 决定 了 由 谁 (指定 脚本 ) 去 响应 客户 端 请 求 。 
在 HTTP 请 求 中 ， 我 们 可 以 通过 路 由 提取 出 请 求 的 URL 以 及 GET/POST 参 数 。 
接 下 来 我 们 扩展 Hello World， 添 加 一 些 功 能 来 处理 更 多 类 型 的 HTTP 请 求 。 


创建 express_demo2.js 文件 ， 代 码 如 下 所 示 : 


var express = require('express'); 
var app - express(); 


// 主页 输出 "Hello World" 
app.get('/', function (req, res) { 
console.log("=R GET XR"); 

res.send('Hello GET'); 
}) 


// POST 请 求 

app.post('/', function (req, res) { 
console.log("=R POST 请 求 "); 
res.send('Hello POST'); 

}) 


// /del user 页 面 响应 
app.delete('/del user', function (req, res) { 
console.log("/del user 响应 DELETE 请 求 " ) ; 

res.send(' 删除 页 面 ' ) ; 
}) 


// /list_user 页 面 GET 请 求 

app.get('/list user', function (req, res) { 
console.log("/list user GET 请 求 " ) ; 
res.send(' 用 户 列表 页 面 ' ) ; 

}) 


// 对 页 面 abcd，abxcd，ab123cd， 等 响应 GET 请 求 
app.get('/ab*cd', function(req, res) { 
console.log("/ab*cd GET 请 求 "); 
res.send( ' 正 则 匹配 ' ) ; 
3) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console.1log(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s", host, port) 


}) 


执行 以 上 代码 : 
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$ node express_demo2.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


接 下 来 你 可 以 尝试 访问 http://127.0.0.1:8081 不 同 的 地 址 ， 查 看 效果 。 


在 浏览 器 中 访问 http://127.0.0.1:8081/list_user， 结 果 如 下 图 所 示 : 
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正则 匹配 


在 浏览 器 中 访问 http:/127.0.0.1:8081/abcd， 结 果 如 下 图 所 示 : 
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用 户 列表 页 面 





在 浏览 器 中 访问 http://127.0.0.1:8081/abcdefg， 结 果 如 下 图 所 示 : 
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Cannot GET /abcdefg 
无 法 解析 该 地 址 


静态 文件 


Express 提供 了 内 和 置 的 中 间 件 express.static 来 设置 静态 文件 如 : BH, CSS, JavaScript 


等 。 
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你 可 以 使 用 express.static 中 间 件 来 设置 静态 文件 路 径 。 例 如 ， 如 果 你 将 图 片 ， CSS， 
JavaScript 文件 放 在 public 目录 下 ， 你 可 以 这 么 写 : 


app.use(express.static('public')); 


我 们 可 以 到 public/images 目录 下 放 些 图 片 , 如 下 所 示 : 


node modules 

server.js 

public/ 

public/images 
public/images/1logo.png 


让 我 们 再 修改 下 "Hello Word" 应 用 添加 处 理 静 态 文件 的 功能 。 


创建 express demo3.js 文件 ， 代 码 如 下 所 示 : 
var express = require('express'); 
var app = express(); 
app.use(express.static('public')); 
app.get('/', function (req, res) { 

res.send('Hello World'); 

}) 
var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console.10g(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s", host, port) 
}) 


执行 以 上 代码 : 


$ node express demo3.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


执行 以 上 代码 : 


在 浏览 器 中 访问 http://127.0.0.1:8081/images/logo.png (本 实例 采用 了 菜 乌 教程 的 logo) , 
结果 如 下 图 所 示 : 


RUNOOB.COM 


GET 方法 


以 下 实例 演示 了 在 表单 中 通过 GET 方法 提交 两 个 参数 ， 我 们 可 以 使 用 serverjs 文件 内 的 
process get 路 由 器 来 处 理 输入 : 


index.htm 文件 代码 如 下 : 


«html» 

«body» 

«form actionz"http://127.0.0.1:8081/process get" method="GET"> 
First Name: <input type="text" name="first_name"> <br> 


Last Name: <input type="text" name="last_name"> 
«input type="submit" value="Submit"> 

</form> 

</body> 

</html> 


server.js 文件 代码 如 下 : 


var express = require('express'); 
var app - express(); 


app.use(express.static('public')); 


app.get('/index.htm', function (req, res) ( 
res.sendFile( _ dirname + "/" + "index.htm" ); 
3) 


app.get('/process get', function (req, res) ( 


// 输出 JSON 格式 
response - ( 
first name:req.query.first name, 
last name:req.query.last name 
}; 
console.log(response); 
res.end(JSON.stringify(response)); 
19) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console,.1og(" 应 用 实例 ， 访 问 地址 为 http://%s:%s", host, port) 


3) 
执行 以 上 代码 : 
node server.js 


应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


浏览 器 访问 http:/127.0.0.1:808TWindex.htm， 如 图 所 示 : 


eoe / |127.0.0.1:8081/indexhtm x 
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First Name: 
Last Name: Submit 


现在 你 可 以 向 表单 输入 数据 ， 并 提交 ， 如 下 演示 : 


eee 127.0.0.1:8081/index.htm — x 


€ C 127.0.0.1:8081/index.htm 


FstNome: T 


Last Name: Submit 





POST 方法 


以 下 实例 演示 了 在 表单 中 通过 POST 方法 提交 两 个 参数 ， 我 们 可 以 使 用 serverjs 文件 内 的 
process get 路 由 器 来 处 理 输入 : 


index.htm 文件 代码 修改 如 下 : 


«html» 

«body» 

«form actionz"http://127.0.0.1:8081/process post" method="POST"> 
First Name: <input type="text" name="first_name"> <br> 


Last Name: <input type="text" name="last_name"> 
<input type="submit" value="Submit"> 

</form> 

</body> 

</html> 


server.js 文件 代码 修改 如 下 : 


var express = require('express'); 
var app = express(); 
var bodyParser - require('body-parser'); 


// 创建 application/x-www-form-urlencoded 编码 解析 
var urlencodedParser = bodyParser.urlencoded({ extended: false }) 


app.use(express.static('public')); 


app.get('/index.htm', function (req, res) ( 
res.sendFile( _ dirname + "/" + "index.htm" ); 
15) 


app.post('/process post', urlencodedParser, function (req, res) ( 


// 输出 JSON 格式 

response = { 
first_name:req.body.first_name, 
last name:req.body.last name 

H 

console.log(response); 

res.end(JSON.stringify(response)); 


}) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console.1og(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s", host, port) 


}) 
执行 以 上 代码 : 
$ node express demo.js 


应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


浏览 器 访问 http://127.0.0.1:8081/index.htm， 如 图 所 示 : 


© © O ， 门 127.0.0.1:8081/indexhtm x 


& 站 127.0.0.1:8081/index.htm 





First Name: 
Last Name: Submit 


现在 你 可 以 向 表单 输入 数据 ， 并 提交 ， 如 下 演示 : 


eee 127.0.0.1:8081/index.htm — x 


€ C 127.0.0.1:8081/index.htm 


First Name: fhe) — 1 | 


Last Name: | Submit 





文件 上 传 


以 下 我 们 创建 一 个 用 于 上 传 文件 的 表单 ， 使 用 POST 方法 ， 表 单 enctype 属性 设置 为 
multipart/form-data. 


index.htm 文件 代码 修改 如 下 : 


«html» 

«head» 

<title> 文 件 上 传 表单 </title> 

</head> 

<body> 

<h3> 文 件 上 传 : </h3> 

选择 一 个 文件 上 传 : «br /> 

«form action-"/file upload" method="post" enctype="multipart/form-data"> 
«input type-"file" name-"image" size-"50" /> 
«br /» 

«input type="submit" value=" 上 传 文件 " /> 
</form> 

</body> 

</html> 


server.js 文件 代码 修改 如 下 : 


var express = require('express'); 
var app = express(); 
var fs - require("fs"); 


var bodyParser - require('body-parser'); 
var multer = require('multer'); 


app.use(express.static('public')); 
app.use(bodyParser.urlencoded(( extended: false })); 
app.use(multer({ dest: '/tmp/'}).array('image')); 


app.get('/index.htm', function (req, res) ( 
res.sendFile( _ dirname + "/" + "index.htm" ); 


3) 
app.post('/file upload', function (req, res) ( 
console.log(req.files[0]); // 上 传 的 文件 信息 


var des file = _dirname + "/" + req.files[0].originalname; 
fs.readFile( req.files[0].path, function (err, data) { 
fs.writeFile(des file, data, function (err) ( 
if( err ){ 
console.log( err ); 
jelset( 
response - ( 
message:'File uploaded successfully', 
filename:req.files[0].originalname 


} 
console.log( response ); 
res.end( JSON.stringify( response ) ); 
3); 
1) 
3) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console,.1og(" 应 用 实例 ， 访 问 地址 为 http://%s:%s", host, port) 


}) 
执行 以 上 代码 : 


$ node express demo.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


浏览 器 访问 http:/127.0.0.1:808TWindex.htm， 如 图 所 示 : 
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€ C | [ò 127.0.0.1:8081/index.htm 


文件 上 传 : 


J 
选择 文件 “未 选择 任何 文件 


Ei 








现在 你 可 以 向 表单 输入 数据 ， 并 提交 ， 如 下 演示 : 


eee |^ node — bash — 89x30 


non CMT tiangixin$ vimil 








[IT 
Cookie 管理 
我 们 可 以 使 用 中 间 件 向 Node.js 服务 器 发 送 cookie 信息 ， 以 下 代码 输出 了 客户 端 发 送 的 
cookie 信息 : 
129 
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dur 
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// express cookie.js 文件 
var express require('express') 
var cookieParser require('cookie-parser') 


var app - express() 
app.use(cookieParser()) 


app.get('/', function(req, res) { 
console.log("Cookies: ", req.cookies) 
}) 


app.listen(8081) 


执行 以 上 代码 : 


$ node express demo.js 


现在 你 可 以 访问 http://127.0.0.1:8081 并 查看 终端 信息 的 输出 ， 如 下 演示 : 









e^o Ml node — bash — 61x16 mE 
tiangixindeMacBook-Pro:node tiangixin$ vim express JJ B. 






4 F 











eo 
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Node.js RESTful API 


什么 是 REST ? 
RREST 即 表述 性 状态 传递 (英文 : Representational State Transfer, “#NREST) 是 Roy 
Fielding 博 士 在 2000 年 他 的 博士 论文 中 提出 来 的 一 种 软件 架构 风格 。 


表述 性 状态 转移 是 一 组 架构 约束 条 件 和 原则 。 满 足 这 些 约束 条 件 和 原则 的 应 用 程序 或 设计 就 
是 RESTful。 需 要 注意 的 是 ，REST 是 设计 风格 而 不 是 标准 。REST 通 常 基于 使 用 HTTP， 
URI， 和 XML 〈 标 准 通用 标记 语言 下 的 一 个 子 集 ) 以 及 HTML (标准 通用 标记 语言 下 的 一 
用 ) 这 些 现 有 的 广泛 流行 的 协议 和 标准 。REST 通常 使 用 JSON 数据 格式 。 


HTTP 方法 
以 下 为 REST 基本 架构 的 四 个 方法 : 
。 GET - 用 于 获取 数据 。 
。 PUT - 用 于 添加 数据 。 
。 DELETE - 用 于 删除 数据 。 
。 POST - 用 于 更 新 或 添加 数据 。 


RESTful Web Services 


Web service 是 一 个 平台 独立 的 ， 低 耦合 的 ， 自 包含 的 、 基 于 可 编程 的 web 的 应 用 程序 ， 可 使 
用 开放 的 XML (标准 通用 标记 语言 下 的 一 个 子 集 ) 标准 来 描述 、 发 布 、 发 现 、 协 调和 配置 这 
些 应 用 程序 ， 用 于 开发 分 布 式 的 互 操作 的 应 用 程序 。 


基于 REST 架构 的 Web Services 即 是 RESTful。 


由 于 轻 量 级 以 及 通过 HTTP 直接 传输 数据 的 特性 ，Web 服务 的 RESTful 方法 已 经 成 为 最 常 
的 替代 方法 。 可 以 使 用 各 种 语言 (比如 Java 程序 、Perl、Ruby、Python、PHP 和 
Javascript[ 包 括 Ajax]) 实现 客户 端 。 


RESTful Web 服务 通常 可 以 通过 自动 客户 端 或 代表 用 户 的 应 用 程序 访问 。 但 是 ， 这 种 服务 的 
简便 性 让 用 户 能 够 与 之 直接 交互 ， 使 用 它们 的 Web 浏览 器 构建 一 个 GET URL 并 读 取 返回 的 
内 容 。 


更 多 介绍 ， 可 以 查看 : RESTful 架构 详解 


创建 RESTful 


首先 ， 创 建 一 个 json 数据 资源 文件 users.json， 内 容 如 下 : 


{ 

"useri" : f 
"name" : "mahesh", 
"password" : "passwordi", 
"profession" : "teacher", 
ito Dig al 

}, 

"user2" : { 
"name" : "suresh", 
"password" : "password2", 
"profession" : "librarian", 
ade A 

}, 

"user3" 1 
"name" : "ramesh", 
"password" : "password3", 
"profession" : "clerk", 
Vas e] 

j 

} 


基于 以 上 数据 ， 我 们 创建 以 下 RESTful API : 


序号 URI 
1 listUsers 
2 addUser 
3 deleteUser 
4 :id 


获取 用 户 列 表 : 


HTTP 方法 


GET 
POST 
DELETE 
GET 


yu 
= 


JSON 字符 串 
JSON 字符 串 


Uu 
TE 


结果 
显示 所 有 用 户 列 表 
添加 新 用 户 
删除 用 户 


显示 用 户 详细 信息 


以 下 代码 ， 我 们 创建 了 RESTful API listUsers， 用 于 读 取 用 户 的 信息 列表 ， servers 文件 代 


码 如 下 所 示 : 


var express = require('express'); 
var app = express(); 
var fs = require("fs"); 


app.get('/listUsers', function (req, res) ( 


fs.readFile( _ dirname + "/" + "users.json", 


console.log( data ); 
res.end( data ); 
3); 
3) 


var server = app.listen(8081, function () { 


var host 
var port 


server.address().address 
server.address().port 


console,1og(" 应 用 实例 ， 访 问 地址 为 http://%s:%s", host, port) 


}) 


接 下 来 执行 以 下 命令 : 


$ node server.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http://127.0.0.1:8081/listUsers， 结 果 如 下 所 示 : 


{ 

"useri" : ( 
"name" "mahesh", 
"password" "password1", 
"profession" "teacher", 
MPS al 

}, 

"user2" : ( 
"name" "suresh", 
"password" "password2", 
"profession" "librarian", 
Ups 2 

}, 

"user3" : f 
"name" "ramesh", 
"password" "password3", 
"profession" "clerk", 
bps By |S 3 

} 

} 


添加 用 户 


以 下 代码 ， 我 们 创建 了 RESTful API addUser, 
如 下 所 示 : 


用 于 添加 新 的 用 户 数 据 ， 


'utf8', function (err, data) { 


server.js 文件 代码 


var express = require('express'); 
var app = express(); 


var fs - require("fs"); 
// 添 加 的 新 用 户 数据 
var user = { 
"user4" : ( 
"name" "mohit", 
"password" "password4", 
"profession" "teacher", 
vidu: TA 
} 
} 


app.get('/addUser', function (req, 
// 读 取 已 存在 的 数据 
fs.readFile( _ dirname + "/" + "users.json", 
data = JSON.parse( data ); 
data["user4"] = user["user4"]; 
console.log( data ); 
res.end( JSON.stringify(data) ); 
1); 
3) 


var server = 


res) { 


app.listen(8081, function () { 


var host - 
var port - 


server.address().address 
server.address().port 


console.1og(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s", host, 


2 


接 下 来 执行 以 下 命令 : 


$ node server.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http://127.0.0.1:8081/addUsers, 2 


{ useri: 

{ name: 'mahesh', 
password: 'password1', 
profession: 'teacher', 
aol di s 

user2: 

{ name: 'suresh', 
password: 'password2', 
profession: 'librarian', 
H2 

user3: 

{ name: 'ramesh', 
password: 'password3', 
profession: 'clerk', 
id: 3 }, 

user4: 

{ name: 'mohit', 
password: 'password4', 
profession: 'teacher', 
id: 4 } 

} 


'utf8', function (err, data) { 


port) 


吉 果 如 下 所 示 : 


以 下 代码 ， 我 们 创建 了 RESTful API :id (FA Pid) , 
server.js 文件 代码 如 下 所 示 : 


var express = require('express'); 
var app - express(); 
var fs - require("fs"); 


app.get('/:id', function (req, res) ( 
// 首先 我 们 读 取 已 存在 的 用 户 
fs.readFile( _ dirname + "/" + "users.json", 
data = JSON.parse( data ); 
var user = data["user" + req.params.id] 
console.log( user ); 
res.end( JSON.stringify(user)); 
3); 
3) 


var server = app.listen(8081, function () { 


var host - server.address().address 
var port - server.address().port 


用 于 读 取 指定 用 户 的 详细 信息 ， 


'utf8', function (err, data) { 


console,.1og(" 应 用 实例 ， 访 问 地址 为 http://%s:%s", host, port) 


}) 


接 下 来 执行 以 下 命令 : 


$ node server.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http:/127.0.0.1:8081/2， 结 果 如 下 所 示 : 


{ 
"name":"suresh", 
"password": "password2", 
"profession": "librarian", 
"id":2 

} 


删除 用 户 


以 下 代码 ， 我 们 创建 了 RESTful API deleteUser, 
中 ， 用 户 id 为 2，serverjs 文件 代码 如 下 所 示 : 


用 于 删除 指定 用 户 的 详细 信息 ， 以 下 实例 


var express = require('express'); 
var app = express(); 
var fs = require("fs"); 


var id = 2; 
app.get('/deleteUser', function (req, res) { 


// First read existing users. 

fs.readFile( _ dirname + "/" + "users.json", 'utf8', function (err, data) { 
data = JSON.parse( data ); 
delete data["user" + 2]; 


console.log( data ); 
res.end( JSON.stringify(data) ); 
3); 
3) 


var server = app.listen(8081, function () { 


var host - server.address().address 
var port - server.address().port 
console.1log(" 应 用 实例 ， 访 问 地 址 为 http://%s:%s", host, port) 


}) 


接 下 来 执行 以 下 命令 : 


$ node server.js 
应 用 实例 ， 访 问 地 址 为 http://0.0.0.0:8081 


在 浏览 器 中 访问 http:/127.0.0.1:8081/deleteUser， 结 果 如 下 所 示 : 


{ user1i: 

{ name: 'mahesh', 
password: 'password1', 
profession: 'teacher', 
aloe al, Fy 

user3: 

{ name: 'ramesh', 
password: 'password3', 
profession: 'clerk', 
id: 3 } 


Node.js 多 进程 
我 们 都 知道 Node.js 是 以 单线 程 的 模式 运行 的 ， 但 它 使 用 的 是 事件 驱动 来 处 理 并 发 ， 这 样 有 
助 于 我 们 在 多 核 cpu 的 系统 上 创建 多 个 子 进 程 ， 从 而 提高 性 能 。 


每 个 子 进 程 总 是 带 有 三 个 流 对 象 : child.stdin, child.stdout 和 child.stderr。 他 们 可 能 会 共享 父 
进程 的 stdio 流 ， 或 者 也 可 以 是 独立 的 被 导 流 的 流 对 象 。 


Node 提供 了 child process 模块 来 创建 子 进程 ， 方 法 有 : 


e exec - child process.exec 使 用 子 进 程 执行 命 售 ， 缓 存 子 进程 的 输出 ， 并 将 子 进 程 的 输出 
以 回调 画 数 参数 的 形式 返回 。 

e spawn - child process.spawn 使 用 指定 的 命令 行 参 数 创建 新 线程 。 

fork - child process.fork 是 spawn() 的 特殊 形式 ， 用 于 在 子 进程 中 运行 的 模块 ， 如 


fork('./son.js') 相当 于 spawn('node', [/son.js]) 。 与 spawn 方 法 不 同 的 是 ，fork 会 在 父 进 
程 与 子 进程 之 间 ， 建 立 一 个 通信 管道 ， 用 于 进程 之 间 的 通信 。 


exec() 方法 

child process.exec 使 用 子 进程 执行 命 依 ， 缓 存 子 进程 的 输出 ， 并 将 子 进程 的 输出 以 回调 本 数 
参数 的 形式 返回 。 

语法 如 下 所 示 : 


child process.exec(command[, options], callback) 


参数 
参数 说 明 如 下 : 
command: 字符 串 ， 将 要 去 行 的 命令， 参数 使 用 空格 隔 开 
options : 对 象 ， 可 以 是 : 
e cwd ， 字 符 串 ， 子 进程 的 当前 工作 目录 
e env， 对 象 环境 变量 键 值 对 
e encoding ， 字 符 串 ， 字 符 编 码 (默认 : 'utf8') 
e shell ， 字 符 串 ， 将 要 执行 命令 的 Shell (默认 : 在 UNIX 中 为 /binysh , 在 Windows 中 


为 cmd.exe , Shell 应 当 能 识别 -c 开关 在 UNIX FB, E /s vc f£ Windows 中 。 在 
Windows 中 ， 命 令 行 解析 应 当 能 兼容 cmd.exe ) 


e timeout, A, iB mpg (默认 : 0) 

e maxBuffer, 2, 在 stdout 或 stderr 中 允许 存在 的 最 大 缓冲 〈 二 进 制 ) ， 如 果 超 出 那 
么 子 进程 将 会 被 杀 死 (默认 : 200*1024) 

e killSignal ， 字 符 串 ， 结 束 信号 (默认 : 'SIGTERM') 

e uid， 数 字 ， 设 置 用 户 进程 的 ID 

e gid， 数 字 ， 设 置 进程 组 的 ID 


callback : 回调 函数 ， 包 含 三 个 参数 error stdout 和 stderr. 


exec() 方法 返回 最 大 的 缓冲 区 ， 并 等 待 进程 结束 ， 一 次 性 返回 缓冲 区 的 内 容 。 


实例 
让 我 们 创建 两 个 js 文件 supportjs 和 masterjs。 


support.js 文件 代码 : 


console.1og(" 进 程 " + process.argv[2] + " 447. " ); 


master.js 文件 代码 : 


const fs = require('fs'); 
const child process = require('child process'); 


for(var i=0; i<3; i++) { 
var workerProcess = child process.exec('node support.js '+i 
function (error, stdout, stderr) { 
if (error) { 
console.log(error.stack); 
console.log('Error code: '+error.code); 
console.log('Signal received: '«error.signal); 


} 
console.log('stdout: ' + stdout); 
console.log('stderr: ' + stderr); 


3); 


workerProcess.on('exit', function (code) { 
console.1og( ' 子 进程 已 退出 ， 退 出 码 '+code ) ; 
i); 
} 


执行 以 上 代码 ， 输 出 结果 为 : 


$ node master.js 

子 进 程 已 退出 ， 退 出 码 0 
stdout: 进程 1 执行 。 
stderr: 

子 进 程 已 退出 ， 退 出 码 0 
stdout: 进程 0 执行 。 
stderr: 

子 进 程 已 退出 ， 退 出 码 0 
stdout: 进程 2 执行 。 


stderr: 


spawn() 方法 
child process.spawn 使 用 指定 的 命令 行 参数 创建 新 线程 ， 语 法 格式 如 下 : 


child process.spawn(command[, args][, options]) 


参数 说 明 如 下 : 

command : 将 要 运行 的 命令 
args : Array 字符 串 参 数 数组 
options Object 


e cwd String 子 进 程 的 当前 工作 目录 

e env Object 环境 变量 键 值 对 

e stdio Array|String 子 进 程 的 stdio 配置 

e detached Boolean 这 个 子 进 程 将 会 变 成 进程 组 的 领导 
e uid Number 设置 用 户 进程 的 ID 

e gid Number 设置 进程 组 的 ID 


spawn() 方法 返回 流 (stdout & stderr)， 在 进程 返回 大 量 数据 时 使 用 。 进 程 一 旦 开始 执行 时 
spawn() 就 开始 接收 响应 。 


实例 
让 我 们 创建 两 个 js 文件 support.js 和 masterjs。 


support.js 文件 代码 : 


console.log(" 进 程 " + process.argv[2] + " 执行。" ); 


master.js 文件 代码 : 
const fs = require('fs'); 
const child process - require('child process'); 


for(var i-0; i«3; i++) { 
var workerProcess - child process.spawn('node', ['support.js', i]); 


workerProcess.stdout.on('data', function (data) { 


console.log('stdout: ' + data); 

1); 

workerProcess.stderr.on('data', function (data) { 
console.log('stderr: ' + data); 

1); 


workerProcess.on('close', function (code) { 
console.1og( ' 子 进程 已 退出 ， 退 出 码 '+code ) ; 


1); 


执行 以 上 代码 ， 输 出 结果 为 : 


$ node master.js stdout: 进程 0 执行 。 


子 进程 已 退出 ， 退 出 码 0 
stdout: 进程 1 执行 。 


子 进程 已 退出 ， 退 出 码 0 
stdout: 进程 2 执行 。 


子 进 程 已 退出 ， 退 出 码 0 


fork 方法 
child process.fork 是 spawn() 方法 的 特殊 形式 ， 用 于 创建 进程 ， 语 法 格式 如 下 : 


child process.fork(modulePath[, args][, options]) 


参数 说 明 如 下 : 

modulePath : String， 将 要 在 子 进 程 中 运行 的 模块 
args : Array 字符 串 参 数 数组 

options : Object 


e cwd String 子 进程 的 当前 工作 目录 

e env Object 环境 变量 键 值 对 

e execPath String 创建 子 进 程 的 可 执行 文件 

e execArgv Array 子 进程 的 可 执行 文件 的 字符 串 参 数 数组 (默认 : process.execArgv) 


e silent Boolean 如 果 为 true ， 子 进程 的 stdin, stdout 和 stderr 将 会 被 关联 至 父 进 
程 ， 否 则 ， 它 们 将 会 从 父 进程 中 继承 。 (默认 为 : false ) 

e uid Number 设置 用 户 进程 的 ID 

。 gid Number 设置 进程 组 的 ID 


返回 的 对 象 除 了 拥有 ChildProcess 实 例 的 所 有 方法 ， 还 有 一 个 内 建 的 通信 信道 。 
h3> 实 例 


让 我 们 创建 两 个 js 文件 support.js 和 master.js。 


support.js 文件 代码 : 


console.1log(" 进 程 " + process.argv[2] + " 执行。" ); 


master.js 文件 代码 : 


const fs = require('fs'); 
const child process = require('child process'); 


for(var i-0; i«3; i++) { 
var worker process - child process.fork("support.js", [i]); 


worker process.on('close', function (code) { 

console.10g(' 子 进程 已 退出 ， 退 出 码 ' + code); 
}); 
} 


执行 以 上 代码 ， 输 出 结果 为 : 


$ node master.js 
进程 O 执行 。 

子 进程 已 退出 ， 退 出 码 9 
进程 1 执行 。 

子 进程 已 退出 ， 退 出 码 9 
进程 2 执行 。 

子 进程 已 退出 ， 退 出 码 9 


Node.js JXcore 打包 


Node.js 是 一 个 开放 源 代 码 、 跨 平台 的 、 用 于 服务 器 端 和 网 络 应 用 的 运行 环境 。 


JXcore 是 一 个 支持 多 线程 的 Node.js 发 行 版 本 ， 基 本 不 需要 对 你 现 有 的 代码 做 任何 改动 就 可 
以 直接 线程 安全 地 以 多 线程 运行 。 


但 我 们 这 篇 文章 主要 是 要 教 大 家 介绍 JXcore 的 打包 功能 。 


ria 


JXcore 安装 


FA JXcore 安装 包 ， 并 解压 ， 在 解压 的 的 目录 下 提供 了 jx 二 进 制 文件 命 舍 ， 接 下 来 我 们 主 
要 使 用 这 个 命令 。 


步骤 1、 下 载 


FA JXcore 安装 包 http://jxcore.com/downloads/， 你 需要 根据 你 自己 的 系统 环境 来 下 载 安装 
&, 


1. Window 平台 下 载 : Download, 


2. Linux/OSX 下 载 安 装 命 售 ， 直 接 下 载 解压 包 下 的 jx 二 进 制 文件 拷贝 到 /usrbin 目录 下 : 


$ wget https://s3.amazonaws.com/nodejx/jx rh64.zip 
$ unzip jx rh64.zip 
$ cp jx rh64/jx /usr/bin 


将 /usr/bin 添加 到 PATH 路 径 中 : 


$ export PATH=$PATH:/usr/bin 


DES RO RR IEA, SALA Rat, Ais Sis: 


$ jx --version 
v0.10.32 


ats 


例如 ， 我 们 的 Node.js 项 目 包含 以 下 几 个 文件 ， 其 中 index.js 是 主 文件 : 


drwxr-xr-x root root 4096 Nov 13 12:42 images 
-rwxr -Xr -x root root 30457 Mar 6 12:19 index.htm 
-rwxr -Xr -x root root 30452 Mar 1 12:54 index.js 


drwxr-xr-x 2 
drwxr-xr-x 
drwxr-xr-x 


root root 4096 Jan 15 03:48 node_modules 
root root 4096 Mar 21 06:10 scripts 
root root 4096 Feb 15 11:56 style 


NNWHREEN 


接 下 来 我 们 使 用 jx 命令 打包 以 上 项 目 ， 并 指定 index.js 为 Node.js 项 目的 主 文件 : 


$ jx package index.js index 


以 上 命令 执行 成 功 ， 会 生成 以 下 两 个 文件 : 
。 index.jxp 这 是 一 个 中 间 件 文件 ， 包 含 了 需要 编译 的 完整 项 目 信 息 。 


e index.jx 这 是 一 个 完整 包 信 息 的 二 进 制 文 件 ， 可 运行 在 客户 端 上 。 


RA JX 文件 
我 们 使 用 jx 命令 打包 项 目 : 


$ node index.js command line arguments 


使 用 JXcore 编译 后 ， 我 们 可 以 使 用 以 下 命令 来 执行 生成 的 jx 二 进 制 文件 : 


$ jx index.jx command line arguments 


更 多 JXcore 功能 特性 你 可 以 参考 官网 : hitp://jxcore.com/。 


免责 声明 


W3School 提 供 的 内 容 仅 用 于 培训 。 我 们 不 保证 内 容 的 正确 性 。 通 过 使 用 本 站 内 容 随 之 而 来 的 
风险 与 本 站 无 关 。W3School 简 体 中 文 版 的 所 有 内 容 仅 供 测试 ， 对 任何 法 律 问题 及 风险 不 承担 
任何 责任 。 


